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OPERATORS SAFETY SUMMARY 


This general safety information is for both operating and servicing personnel. Specific warnings and cautions will be found 
throughout the manual where they apply, but may not appear in this summary. 


TERMS 


IN THIS MANUAL 


CAUTION statements identify conditions or practices that 
can result in damage to the equipment or other property. 


WARNING statements identify conditions or practices that 
can result in personal injury or loss of life. 


AS MARKED ON EQUIPMENT 
CAUTION indicates a personal injury hazard not immedi- 
ately accessible as one reads the marking, or a hazard to 


property including the equipment itself. 


DANGER indicates a personal injury hazard immediately 
accessible as one reads the marking. 


SYMBOLS 


IN THIS MANUAL 


This symbol indicates where applicable cautionary or 
other information is to be found. 


As Marked on Equipment 


gS DANGER high voltage. 


& Protective ground (earth) terminal. 


ATTENTION — refer to manual. 
Refer to manual. 
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POWER SOURCE 


This product is designed to operate from a power source 
that does not apply more than 250 volts rms between the 
supply conductors or between either supply conductor and 
ground. A protective ground connection by way of the 
grounding conductor in the power cord is essential for safe 
operation. 


GROUNDING THE PRODUCT 


This product is grounded through the grounding conductor 
of the power cord. To avoid electrical shock, plug the power 
cord into a properly wired receptacle before connecting to 
the power input or output terminals. A protective ground 
connection by way of the grounding conductor in the power 
cord is essential for safe operation. 


DANGER ARISING FROM 
LOSS OF GROUND 
Upon loss of the protective-ground connection, all accessi- 


ble conductive parts (including knobs and controls that may 
appear to be insulating) can render an electric shock. 


USE THE PROPER POWER CORD 


Use only the power cord and connector specified for your 
product. 


Use only a power cord that is in good condition. 


Refer cord and connector changes to qualified service 
personnel. 
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USE THE PROPER FUSE DO NOT REMOVE COVERS OR PANELS 


To avoid fire hazard, use only the fuse specified in the parts To avoid personal injury, do not remove the product covers 
list for your product, and which is identical in type, voltage or panels. Do not operate the product without the covers 
rating, and current rating. and panels properly installed. 


Refer fuse replacement to qualified service personnel. 


DO NOT OPERATE IN 
EXPLOSIVE ATMOSPHERES 


To avoid explosion, do not operate this product in an atmo- 


sphere of explosive gases unless it has been specifically 
certified for such operation. 
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Figure 1-1. The 41158 Computer Display 
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Figure 1-2. The M4115B Computer Display Terminal. 
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INTRODUCTION 


ABOUT THIS MANUAL 


This manual introduces you to the TEKTRONIX 4115B and 
M4115B Computer Display Terminals, which come with 
firmware version 6.0 and greater. This manual discusses in 
detail the terminals’ features and capabilities that you, the 
operator, might use. The manual is organized like this: 
Section 1 Contains introductory material about the 
4115B and the M4115B terminals, their 
features, and their capabilities. 


Describes all external controls, the 
light indicators, the keyboard, and the 
connectors. 


Section 2 


Discusses files and file transfers. Also 
describes the various peripheral devices 
that you may use with the terminal, includ- 
ing typical terminal operations with these 
devices. 


Section 3 


Section 4 Introduces GIN (Graphics Input) mode. 
Discusses the various terminal communi- 
cations modes and parameters. The cor- 
rect parameter settings are necessary for 
communications with the host and periph- 
eral devices. (Table 5-1 summarizes these 
parameters for handy reference.) 


Section 5 


Section 6 Contains a command dictionary of all setup 


commands that you will normally use. 
Appendices The appendices contain various types of 
reference information. For example, they 
contain information on the terminal’s error 
messages, the power-up sequence, the 
terminal's self test, the optional keyboards, 
ASCII code charts, and the escape 
sequence commands normally issued from 
the host. Appendix F is a tutorial designed 
to acquaint you with the terminal. 


Before reading this manual, please complete the tutorial 
exercises in Appendix F (or in the 4//5B Introduction 
Brochure — the same exercises are contained in both 
documents) to become familiar with the basic features and 
operation of the terminal. 
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RELATED DOCUMENTATION 


In addition to this operators manual, you may want to refer 
to these manuals: 


© 4115B Introduction Brochure 

VY 4110 Series Host Programmers Manual 

O 4/10 Series Command Reference Manual 

© 4/10 Series Reference Guide 

Appendix H lists additional documentation — for servicing 


the terminal and for the terminal’s options — and provides 
ordering information. 


THE 41158 OR Wl41158 PACKAGE 


The standard 4115B or M4115B Computer Display Terminal 
package includes: 


Oo The 4115B Computer Display Terminal (with the display, 
the keyboard, and the pedestal, as shown in Figure 1-1), 
OR the M4115B Computer Display Terminal (with the 
display, the keyboard, and the electronics module, as 
shown in Figure 1-2) 


© 4//5B Introduction Brochure 


O 4115B/M4115B Computer Display Terminal Operators 
Manual (this manual) 


4110 Series Host Programmers Manual 

4110 Series Command Reference Manual 

4110 Series Reference Guide 

Power cord set (two cords) 

Display cables (8 BNC cables and 1 control cable) 
One RS-232-C host port cable 


Or > 2 8: Oe Oe. 


Six function key overlays 


Appendix H lists accessories for the terminal. 
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GENERAL DESCRIPTION 


The 4115B and M4115B Computer Display Terminals are 
microprocessor-controlled color graphics and alphanumeric 
terminals. 


The display on the 4115B is not attached to the 
pedestal. If you move the pedestal, be sure that the 
display does not fall. 


The 4115B terminal (Figure 1-1) consists of a 19-inch dis- 
play that sits on a pedestal base containing the electronics; 
the keyboard sits on a tray that conveniently slides out of 
the pedestal. 


The M4115B terminal (Figure 1-2) is a modular version of 
the 4115B terminal. The M4115B consists of the same 19- 
inch display, the same keyboard, and a separate electronics 
module (instead of a pedestal). The display and keyboard 
cables supplied with the M4115B are longer, allowing you to 
position the electronics module a few feet away from the 
display. 


TERMINAL FEATURES AND CONCEPTS 


These are the main features of the 4115B and M4115B 
Computer Display Terminals: 


@ A resolution of 1280 x 1024 pixels gives high-quality 
graphics displays. (A pixel is the smallest visible dot on 
the crt screen.) 


@ A 32-bit terminal coordinate space is addressable at over 
4 billion points along each coordinate axis. Because of 
this high internal data resolution, when you use the ter- 
minal’s ZOOM and PAN features to expand a portion of 
the display, the terminal maintains the sharpness and 
detail of the image. 


@ Multiple bit planes give up to eight separate graphics 
surfaces (with Option 23) that can be displayed indepen- 
dently. (A bit plane refers to memory used for storing 
graphics information.) 


@ A separate dialog plane is used to display your conversa- 
tions with the terminal or the host computer. The dialog 
text can be displayed ‘“‘over’’ the graphics, allowing your 
graphics to be visible behind the text. Or, by toggling the 
DIALOG key, you can make the dialog text invisible, to 
view only the graphics. (Figure 1-3 is a black and white 
representation of this feature.) 
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@ The terminal’s thumbwheels provide an easy means to 
scroll through dialog text, to send graphics input (GIN) 
information to the host, and to define a new view when 
using the terminal’s viewing keys. 


@ The terminal simultaneously displays up to 256 colors 


(with Option 23) from a palette of over 16 million different 
colors. 


@ An autoconvergence feature assures maximum color 


quality and integrity. (Autoconvergence is the process of 
realigning the red, blue, and green color beams that 
create colors on the display. See The DEGA USS/CON- 
VERGE Button in Section 2.) 


*STATUS COMMUNICATIONS 
COMMUNICATIONS 
ATE 4 


"+80 


Figure 1-3. The Graphics and Dialog Areas. 
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© A drawing speed of up to 50,000 vectors a second, along 
with data transmission speeds of up to 19,200 bits per 
second, allows the terminal to redraw complex displays 
almost instantaneously. 


© Adetached low-profile keyboard provides convenient, 
comfortable typing. 


© The keyboard’s indicator lights inform you when the 
terminal is in a particular mode, when it is transmitting or 
receiving data, or when it detects an error during its self- 
test procedures. 


© The self-test diagnostic programs in the terminal’s firm- 
ware check the terminal’s operation each time it is 
turned on. If an error is detected, the terminal displays a 
pattern on the light indicators or a message on the dis- 
play screen. You can then report these messages to your 
Tektronix service technician to correct the problem more 
quickly. 


© An optional color copy interface (Option 09) lets you 
make color copies of the screen ona TEKTRONIX 4691 
Color Graphics Copier. With the three-port peripheral 
interface option (Option 10), the terminal can also make 
color plots ona TEKTRONIX 4662 or 4663 Interactive 
Digital Plotter. (The terminal’s options and compatible 
Tektronix products are listed at the end of this section.) 


The Graphics Area 


The terminal is designed for high-speed graphics informa- 
tion processing. It contains a firmware-resident command 
set that includes several dozen graphics commands. (The 
4110 Series Command Reference Manual documents the 
commands.) 


Using graphics commands, either stored locally on the 
terminal or from a host software program, the terminal can 
create and modify color graphics images in the graphics 
area. (The graphics area refers to the area on the screen 
where the terminal displays graphics pictures, as opposed 
to the dialog area, which displays your conversations with 
the terminal and the host. See Figure 1-3.) 


Other graphics commands can cause the terminal to trans- 
mit data back to the host computer, to store graphics ona 
local mass-storage device, or to produce high-quality color 
hard copies of the display. 


Segments. A graphics segment is a part of a picture that can 


be manipulated as a unit by terminal commands or with the 
viewing keys. 
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In the tutorial session in Appendix F, Example 4 shows you 
how to create segments using the terminal’s graphics com- 
mands. Then Example 5 illustrates how to manipulate 
graphics segments with commands and the viewing keys. 


Figure 1-4 shows the viewing keys. With the ZOOM and 
PAN keys you can focus in on a part of asegment and press 
the VIEW key to display it. By ZOOMing and PANning sev- 
eral times, you can enlarge a part of a segment in detail. 
With the OVERVIEW key, you can get an overview window 
that shows the portion of the segment you expanded with 
ZOOM and PAN. While you are using the viewing keys, you 
can redisplay the previous view by pressing the RESTORE 
key. (Section 2 includes a more thorough description of the 
viewing keys and the operations you can perform with 
them.) 


Surfaces. Using multiple bit planes, the terminal can dis- 
play up to eight separate graphics surfaces. (A bit plane 
refers to the terminal memory used to store each graphics 
surface.) Each surface has its own assignment of colors and 
can display its own set of graphics information. Surfaces 
can be displayed in various modes to allow later graphics to 
obscure earlier graphics, or to allow the earlier graphics to 
show through (like layers of colored glass). 


Multiple Views. The screen can be divided into as many as 
64 individual views, each with its own viewport, window, 

etc. (A viewport is an area on the screen where the window 
is displayed; a window refers to the portion of terminal 
memory currently displayed. The 47/0 Series Host Program- 
mers Manual contains more information on these concepts.) 
You can manipulate the segments in each view with the 
viewing keys. 


Figure 1-4. The Viewing Keys. 
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Graphics Input (GIN). Graphics input (or GIN) mode allows 
you to send graphic information to a host-resident program 
from the terminal, a plotter, or a graphics tablet. With the 
thumbwheels (Figure 1-5) you can move the GIN cursor and 
select information to send to the host. Section 4 gives an 
overview of GIN mode, and the 4//0 Series Host Program- 
mers Manual explains GIN concepts in more detail. 


The Dialog Area 


You can display your conversations with the terminal or host 
computer in the graphics area, or you can display them in 
the dialog area. The dialog area is a portion of the screen 
that you define for displaying terminal and host commands. 


Because the dialog area is assigned a separate “surface” 
in the terminal from the graphics surfaces, you can display 
dialog text without it interfering with graphics on the termi- 


nal screen. You can make the dialog text visible or invisible | 


(by pressing the DIALOG key, for example) to switch back 
and forth between graphics and dialog text. With the 
thumbwheels (Figure 1-5), you can scroll up or down in the 
dialog area. 


Figure 1-5. The Thumbwheels. 
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The dialog buffer is a part of terminal memory that stores 
the dialog text. When the dialog area is enabled and visible, 
text in the dialog buffer is displayed in the dialog area. 
When the dialog area is invisible, the dialog area retains 
dialog text for the next time you make the area visible. 


The terminal responds to a set of ANS/ commands but only 
when those commands are issued in the dialog area. The 
ANSI commands are a subset of the text-editing commands 
specified in ANSI Standard X3.64V (ISO Standard 6429). 
They allow you to use the terminal as an alphanumeric 
terminal to create and modify text in the dialog area. Using 
color in the dialog area can enhance the impact or content 
of the text. (See the 47/0 Series Command Reference Man- 
ual for descriptions of the ANSI commands.) 


The dialog area is discussed in more detail in Section 2 
(under the discussion of the DIALOG key). 


Setup Mode 


In Setup mode, you can prepare (or “set up’) the terminal 
for a variety of functions, with English-like setup commands. 
These commands are used, for example, to prepare the 
terminal for communications, to describe and position the 
dialog area, to specify what errors the terminal should 
report, to control peripheral functions, and to perform other 
terminal functions. 


You can enter setup commands directly from the keyboard, 
or they may come from the host computer, perhaps in an 
initialization program. Section 6 is a dictionary that 
describes the setup commands in detail. 


To place the terminal in Setup mode, press the SETUP key 
at the top of the keyboard. The red light in the key goes on 
to indicate that Setup mode is active. To exit Setup mode, 
just press the Setup key again. 


Most setup information is retained even when the terminal 
is turned off. This means that you do not need to reenter 
setup commands every time you use the terminal, unless 
you want to change some of the setup parameters. 


Each setup command has an equivalent escape sequence 
command (an escape sequence command is a graphics com 
mand that begins with the escape (fc) character). You can 
enter both setup commands and escape sequence com- 
mands in Setup mode. (Refer to the 47/0 Series Command | 
Reference Manual for descriptions of the escape sequence 
commands.) 
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crror Reporting 


When the terminal detects an error condition, it is recorded 
in an internal error queue and may be displayed on the 
screen. There are four levels of errors. You can establish an 
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TERMINAL OPTIONS 


The following options are available for the 4115B and 
M41158 terminals: 


error threshold. which determines what level of error mes- Option01 Extended Communications Interface —includes 
sages are displayed on the screen, with the setup command half-duplex and block mode. 
ERRORLEVEL (see ERRORLEVEL in Section 6). Option 09 Interface for TEXTRONIX 4691 Color Graphics 
Other error messages — associated with the disk or three ones 
port peripheral interface options — may appear on the Option 10 Three-Port Peripheral Interface (SPP). 
screen to indicate a hardware-related problem. Option 13 Graphic Tablet (size: 11 x 11”) with controller. 
Appendix A lists the terminal’s error messages. Option 14 Graphic Tablet (size: 30 x 40”) with controller. 
Option 22 Additional 2 Planes Display Memory (increases 
eee sia gales | f ilable bit-pl f four to 
SOFTWARE SUPPOR) oo of available bit-planes from four 
The 4115B and M4115B terminals are compatible with 4010 Option 23 Additional 4 Planes Display Memory (increases 
Series graphics software. In most cases, a program written the number of available bit-planes from four to 
for a Tektronix 4010 Series terminal can be executed eight). 
PHMOG EO On Ae SO GEM See VO e make modi Option 2A Additional 256K Bytes (for 512K byte total) ECC 
cations to existing software to take advantage of the new Memory; additional RAM Array board. 
4115B jeatures — color, use of the dialog area, new fea- . . 
tures of GIN (Graphics Input), and new graphics features Option 2B Additional 512K Bytes (for 768K byte total) ECC 
(such as segments and panels). Memory; additional Controller board and two 
RAM Array boards. 
These TEKTRONIX PLOT 10 products can drive the 4115B Option 3A DMA Interface (for PDP-11 and VAX 
and M4115B terminals: computers). 
© Interactive Graphics Library Option 3B 30-foot cable for Option 3A. 
° Terminal Control System and associated packages Option 42 Single Flexible Disk and Controller (includes 
oO Easy Graphing Option 45 with Mass Storage Interface 
connector). 
If you are already using 4110 Series software, the transition Option 43 Dual Flexible Disks and Controller (includes 
is even simpler — any 4110 Series software should run on Option 45 with Mass Storage Interface 
the 4115B and M4115B as is. You may want to enhance connector). 
existing 4110 Series programs, however, to take advantage 
of the 4115B and M4115B’s wider range of color and larger Option 45 Mass Storage Interface. 
coordinate space. Option 46’ Single 10-Megabyte Disk (without controller; 
requires Option 42 or Option 45; cannot be 
used with Option 43). 
Option 47' Dual 10-Megabyte Disks (without controller; 
requires Option 42 or Option 45; cannot be 
used with Option 43). 
M4115B only. 
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Option 49 
Option 4A 
Option 4C 
Option 4F 
Option 4K 
Option 52 


Option At 
Option A2 
Option A3 
Option A4 


Option A5 


1-6 


Rental identification tag. 
United Kingdom keyboard. 
Swedish keyboard. 
Danish/Norwegian keyboard. 
Katakana keyboard. 


Customer Specified Line Voltage, frequency, 
and power cord. 


Universal European Line voltage, frequency, 
and power cord: 220 V, 16A, 50 Hz. 


United Kingdom line voltage, frequency, and 
power cord: 240 V, 13 A, 50 Hz. 


Australian line voltage, frequency, and power 
cord: 240 V, 10 A, 50 Hz. 


North American line voltage, frequency, and 
power cord: 240 V, 15 A, 60 Hz. 


Swiss line voltage, frequency, and power cord: 


220 V, 6A, 50 Hz. 
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COMPATIBILITY 


The 4115B and M4115B terminals are compatible with the 
following Tektronix products: 


@ 4691 Color Graphics Copier 

4662 and 4663 Interactive Digital Plotters 

4925 Dual 5%-Inch Flexible Disk Drives 

4926 10-Megabyte Hard Disk Drive 

4926 Option 26 Dual 10-Megabyte Hard Disk Drives 


4926 Option 25 10-Megabyte Hard Disk with Dual 5%- 
Inch Flexible Disk Drives 


@ 4641, 4641-1, and 4643 Line Printers 
@ 4923 Option 01 Digital Cartridge Tape Drive 


Section 3 contains additional information on connectors 
for some of these peripheral devices and typical device 
operations. 


4115B OPERATORS 


ox 


CONTROLS, INDICATO 


ABOUT THIS SECTION 


This section introduces you to the controls, indicators, key- 
board, and connectors for the 4115B and M4115B termi- 
nals. This section covers: 


© The controls and light indicators on the 4115B and 
M4115B terminals. 


© The keyboard layout and special keys. 
© The connectors on both terminals. 
This section describes the locations of the controls, indica- 


tors, switches, and keys that you will use to operate the 
terminal. 


On the 4115B terminal, the controls, indicators, and con- 
nectors are located on the display and the pedestal; on tne 
M4115B terminal, they are located on the display and the 
electronics module. 


This section first describes the controls and indicators that 
are located on the front of the pedestal, the electronics 
module, and the display, in this order: 


Pedestal or Electronics Module 
Oo POWER switch 
MASTER RESET button 
SELF TEST button 
WRITE PROTECT switches (Options 42, 43) 
WRITE PROTECT indicators (Options 42, 43) 


GO OO OO 6 


© Disk Drive Indicators 

Display Unit 
&® DEGAUSS/CONVERGE button 
O INTENSITY control 
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Section 2 


AS, AND KEYBOARD 


After the descriptions of the controls and indicators, this 
section introduces the keyboard — the keyboard indicator 
lights, the keyboard layout, and the special function keys. 
Then this section briefly discusses the terminals’ connec- 
lors; most connectors are located on the rear panel of the 
4115B pedestal or M4115B electronics module, or on the 
rear panel of the display. 


CONTROLS ON Tre PEDESTAL OR 
ceLECTRONICS MODULE 


THE POWER SWITCH 


Figure 2-1 shows the location of the POWER switcn on the 
4115B and M4115B terminals. The POWER switch controls 
AC power to the entire terminal (even though the display, 
the pedestal, and the electronics module each have their 
own AC power cord — see Connectors later in this section). 


caution | 


CAUTION : 


I~ 


Do not block the air vents (Figure 2-2) on either the 
display unit, the pedestal, or the electronics mod- 
ule. If any vents are blocked, the terminal may 
overheat, causing damage to its circuitry. (The 
bumpers on the sides of the electronics module will 
help ensure that you do not accidentally block the 
module’s air vents.) 


To turn the terminal on, push the POWER switch in until it 
clicks; then release it. A green indicator appears in the 
switch to indicate that the power is on. You should hear the 
ventilation fans inside the pedestal or the electronics mod- 
ule turn on. 


ho 
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RANT 


The POWER Switch 


-1 


2 


F 
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ELECTRONICS MODULE 
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Figure 2-2. The Air Vents. 
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The Power-Up Sequence lf the power-up sequence detects an error, the terminal bell 
rings one, two, or three times, depending on the severity of 

Each time you turn the terminal on, it automatically tests the problem. There may also be a message on the screen. If 

parts of its memory and circuitry. This is called the power-up _ this occurs, see Appendix A. 

sequence. \t takes from 15 to 60 seconds, depending on 

what options your terminal has. If the power-up sequence is successful, the cursor flashes 
in the upper left corner of the screen. As soon as the cursor 

During the power-up sequence, the lights in the keyboard appears on the screen, the terminal is ready for use. If the 

(Figure 2-3) go through the following sequence: dialog area is enabled (see DIALOG later in this section), 
the cursor appears on the first available line of the dialog 

1.  Alllights turn on. area. 


2. The CAPS LOCK light turns off. 


3. Allother lights turn off. 


4. The XMT and RCV lights flash once 
simultaneously. 


RRS 


= 

SSS 
i SESS 
3 RASS Ss \ S 
ASS 


LIGHTS ACTIVE 
DURING 
-POWER-UP SEQUENCE 


Figure 2-3. The Power-Up Indicator Lights. 
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Power-Up Defaulis 


With setup commands entered from the host or directly from 
the terminal, you can alter certain parameters that conirol 
the terminal's operating environment. The terminal stores 
the results of these changes in its setup memory and 
remembers the changes even when the terminal is turned 
off. Table 6-1 (in the beginning of Section 6) lists these 
power-up defaults. 


Table 6-1 also lists the factory defaults for the terminal’s 
operating environment. Factory default means the setting 
that the terminal has when it is shipped from the factory. If 
you alter any parameters with setup commands, the status 
of your terminal may differ from what Table 6-1 shows. You 
can use the STATUS command to determine the current 
status of most operating parameters; see the description of 
the STATUS command in Section 6. 


If the terminal’s setup memory fails, the operating environ- 
ment returns to the factory default settings. If this happens, 
the terminal displays the message: 


SETUP DEFAULTS RESET 
during the power-up sequence (see Appendix B). 
At times, you may want to reset the parameters to the fac- 


tory default settings; for this procedure, see the heading 
Resetting Setup Memory in Appendix B. 


Setup mode and setup commands are discussed later in 


this section under the heading SET UP; Section 6 describes 
each setup command individually. 
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THE RESET BUTTON 


NOTE 


Do not press the RESET button tf there is tmpor- 
tant information stored in the terminal’s memory. 
Resetting the terminal deletes all graphics data as 
well as macros that have been programmed into 
Keys. 


Pressing the RESET button (Figure 2-4) has the same effect 
as turning off the terminal and turning it back on again: 


© Macros are deleted from any programmed keys. 


© Graphics data is deleted from the terminal’s main 
memory. 


© The terminal runs its power-up Sequence. 


S The screen is erased. 


You can save information before resetting the terminal by 
saving the data in a host file, or by saving it to a disk file if 
you have one of the disk drive options (See Section 3). Or, if 
you have a hard copy unit connected, you can make a hard 
copy of the screen (the HARD COPY key is discussed later 
in this section). 


THE SELF TEST BUTTON 


Pressing the SELF TEST button in conjunction with the 
RESET button (Figure 2-4) starts an extensive test of the 
terminal. This self-test provides information so that a ser- 
vice technician can make necessary adjustments to the 
terminal. Appendix B gives a more detailed explanation of 
self-test. 


The SELF TEST and RESET buttons are also used together 
to reset the terminal’s parameters to their factory default 
settings. Appendix B includes the procedure for restoring 
the factory default settings. 
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WRITE PROTECT SWITCH AND INDICATOR(S) 


The terminal may have one or two flexible disk drives 
(Options 42 and 43). These are located in the pedestal 
(4115B) or in the electronics module (M4115B). Figure 2-5A 
shows where the write-protect switch is located on the 
4115B pedestal; Figure 2-5B shows the write-protect switch 
on aM4115B’s electronics module. 


When a disk is in a drive and you turn on the WRITE PRO- 
TECT switch, the disk in the drive is write-protected. When a 
disk is write-protected, the terminal will not write data on it. 
This prevents you from writing over (and thus destroying) 
data already on a disk. 


Press the switch up to protect the disk (and turn on the 
light). You can also protect a disk by covering the write- 
protect notch in the disk itself (see Section 3). 


NOTE 


Individual files on a disk can also be write-pro- 
tected. See the PROTECT command description in 
Section 6. 


If there is no disk in a drive, the red WRITE PROTECT light 
is always on; it cannot be turned off. 


DISK DRIVE INDICATOR(S) 


When the red disk drive indicator (Figure 2-5) is on, the disk 
drive is active; the drive is either reading from or writing to 
the disk. When the light is off, the drive is not operating. 


~~~ ~~ i aw i 


CAUTION 


a a a 


Do not open the disk drive’s door when the disk 
drive indicator light is on and the drive is operating. 
Doing so interrupts the read or write operation in 
progress. Wait until the read or write is finished and 
the light goes out before removing the disk. 


Section 3 explains the use of the disk drives. 
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WRITE PROTECT WRITE PROTECT 
INDICATOR SWITCH 
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Figure 2-5. The WRITE PROTECT Switch, the WRITE PROTECT 


indicator, and the Disk Drive Indicator. 
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THE DISPLAY CONTROLS 


THE DEGAUSS/CONVERGE BUTTON 


Pressing the DEGAUSS/CONVERGE button (Figure 2-6) 
initiates the display’s autoconvergence process — the proc- 
ess of “converging” or aligning the red, green, and blue 
beams that create colors on your display. 


Occasionally the colors on your display may appear to be 
impure or muddled. (For example, you may notice a shadow 
of one color behind text characters or graphics of another 
color.) When the display unit is subjected to normal varia- 
tions in electrical or magnetic field intensity, the purity and 
accuracy of colors may be degraded. If you notice some 


deterioration of colors, press and release the DEGAUSS/ 
CONVERGE button. 


Pressing the button erases the screen momentarily; then a 
series of red, green, and blue bars repeats in different loca- 
tions on the screen. This repetitive flashing of color bars 
aligns the beams in various parts of the screen. After the 
bars stop flashing, the display is restored, and the quality of 
the colors should be improved. 


THE INTENSITY CONTROL 


The INTENSITY control is used to adjust the intensity — or 
brightness — of the display (Figure 2-6). Turn the control 
clockwise to brighten the display; turn it counterclockwise to 
dim the display. 


Figure 2-6. The Display Controls. 
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TRE KEYBOARD 


ee KEYBOARD PAGE 
The keyboard is shown in Figure 2-7. LOCK FULL XMT RCV 


a 


The keys can be grouped into six categories: 
oO ASCII Keys 

Oo The Thumbwheels 

oO The Break Key 

©& Command Keys 

© Function Keys 


oO Viewing Keys 


INDICATOR LIGHTS 


The keyboard also includes four indicator lights (Figure 2-8): Soa apeiceunaaralinnt ae 
the KYBD LOCK light, the PAGE FULL light, the XMT light, igure 2-8. fhe Keyboard Inatcator Lights. 
and the RCV light. 


FUNCTION INDICATOR COMMAND 
KEYS LIGHTS KEYS THUMBWHEELS 


COMMAND 
KEYS 


ASCII KEYS THE BREAK VIEWING 
(TYPEWRITER-LIKE KEYS) KEY KEYS 


4665-4 


Figure 2-7. The Keyboard 


4115B OPERATORS REV, JAN 1984 2-9 


CONTROLS, INDICATORS, AND KEYBOARD 


KYBD LOCK 


When the KYBD LOCK light (Figure 2-8) is on, the keyboard 
is locked. A program may lock the keyboard to prevent you 
from typing anything at a time when doing so would inter- 
fere with data being sent from the host. 


When the keyboard is locked, you can still press the keys, 
but data is not transmitted, echoed, or queued. When you 
press any key (except Break or CANCEL) the terminal’s bell 
rings to remind you that data is not being input. 


The program should unlock the keyboard when the trans- 
mission of the critical data is complete. 


You can also unlock the keyboard by pressing the MASTER 
RESET button or the CANCEL or Break keys. However, you 
should use MASTER RESET, CANCEL, and Break with 
caution. The MASTER RESET button deletes information in 
the terminal’s memory, including any text or graphics cur- 
rently stored there. The CANCEL key terminates several 
terminal functions besides the locked keyboard. The Break 
key can have undesirable effects on some host computers. 


For further details, see the explanations of MASTER 
RESET, Break, and CANCEL in this section and the 
LOCKKEYBOARD command in Section 6. 


PAGE FULL 


When the PAGE FULL light (Figure 2-8) is on, the terminal is 
in the “page-full” condition. It will not display any more text 
or graphics until the page-full condition is cleared by: 


@ Pressing the HARD COPY key, which makes a copy of 
the page, clears the screen, and allows another page to 
be displayed. 


@ Pressing the Page key, which clears the screen and 
allows another page to be displayed. 


@ Pressing any key except Shift, which eliminates the 
page-full condition and allows the display to write new 
data over existing data. 
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The terminal can also be set to make a hard copy of the 
screen, erase the screen, and continue automatically when 
it reaches a page-full condition. See the PAGEFULL setup 
command in Section 6 for details. 


XMT 


The abbreviation XMT stands for transmit. The transmit 
light (Figure 2-8) is on when data is being sent from the 
terminal to the host computer. 


RCV 


The abbreviation RCV stands for receive. The receive light 
(Figure 2-8) is on when data is being received by the termi- 
nal from the host computer. 


THE THUMBWHEELS 


The thumbwheels (Figure 2-9) have three uses: 
® To scroll the dialog area. 


@ To move the GIN cursor. This cursor is used to locate a 
point on the screen to be sent to a graphics program 
being run from a host computer. 


@ To manipulate the framing box when the terminal is in 
Framing mode. 


The dialog area is discussed later in this section, under the 
heading DIALOG. Using the thumbwheels when the termi- 
nal is in Graphics Input (GIN) mode is discussed in 

Section 4. Examples of how to use the thumbwheels are 
contained in Appendix F or in the 4775B Introduction 
Brochure. 
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THE ASCil SECTION 


The main keyboard section consists of the ASCII keys (see 
Figure 2-7), so called because each one generates one of 
the ASCII characters (see the ASCII Code Chart appendix). 
The ASCH keys are divided into alphanumeric keys and 
control keys. These are discussed under the following 
headings. 


Figure 2-9. The Thumbwnheels. 
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Alphanumeric Keys 


NOTE 


Four optional keyboards are available for interna- 
tional use (see Appendix E). Descriptions in this 
section apply only to the standard keyboard. 


The alphanumeric section of the keyboard looks like a type- 

writer keyboard (Figure 2-10). The alphanumeric keys trans- 
mit the characters shown on their keycaps to the terminal or 
to a host computer. These are also called printing characters 
since they have symbolic representations which are printed, 
or echoed, on the screen or printed by a line printer. 


The space is a printing character. 


If the terminal's Autorepeat feature is enabled and you hold 
down an alphanumeric key for more than half a second, the 
character repeats at a rate of 10 times per second until you 
release the key or press another key. 


When the terminal is in Local or Setup mode and you press 
an alphanumeric key, it is displayed (echoed) on the screen. 
Whether the characters are echoed when you are logged 
onto a host computer depends on whether the terminal or 
the host is providing the echo. See the ECHO command in 
Section 6 for details. 


The character normally transmitted by an alphanumeric key 
can be replaced by a macro (a character or character string 
programmed into the key). This is explained later in this 
section under the heading Function Keys. 


ASaa-15 


Figure 2-10. The Alphanumeric Keys. 
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Control Keys 


A control character is a character that has special meaning 
for the terminal or host computer. The terminal can send 
and receive all standard control characters. When some 
control characters are transmitted, you cannot see their 
result on the display. Others, however, cause visible 
changes in the display. For example, the carriage return 
control character causes the cursor to return to the left 
margin; the line feed control character causes the cursor to 
move down one line. 


There are six control characters that have their own keys 
(Figure 2-11): 
@ Rub Out (delete) 

Line Feed (line feed) 

Back Space (backspace) 


® 
@ 
@ Rtn (carriage return) 
@ Esc (escape) 

© 


Tab (horizontal tab) 


The Ctrl and Shift keys are included in the following descrip- 
tion of the control keys because they are used to specify 
control characters that are not represented on the 
keyboard. 


The Rub Out Key. The Rub Out key sends the rub out (or 
delete) character. 


Rub Out is the factory default character delete key in Setup 
mode. See the explanation of the EDITCHARS command in 
Section 6. 


The Line Feed Key. This key sends the /ine feed character, 
which causes the cursor to move down to the next line with- 


out returning it to the left margin. If the cursor is at the bot- 
tom of the screen and is not in the dialog area, a line feed 
moves it to the top of the screen one margin to the right of 
the current margin. When the cursor is at the bottom of the 
last column, a line feed either causes it to move to the top of 
the first column or causes a page-full condition (see 
PAGEFULL in Section 6). 


Back Rub 
Space Out 
Esc Line 
Feed 
Tab 
Ctrl Shift Return 
4665-16 
Figure 2-11. The Control Keys. 
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You can use the setup command LFCR to cause a line feed 
received from the host computer (or from the terminal when 
it is in Local mode) to cause the terminal to generate a line 
feed and carriage return (see Section 6). 


The Back Space Key. The Back Space key sends the back- 
space character, which moves the cursor one character 
position to the left. 


The following explanation applies when the terminal is not 
in Setup mode or connected to a host. If the cursor is in the 
dialog area and is already at the left margin when you press 
the Back Space key, the cursor does not move. If the cursor 
is not in the dialog area and is already at the left margin 
when you press the Back Space key, there is no effect. 


The Rin Key. The Rtn key sends the carriage return control 
character, which returns the cursor to the left margin of the 
current line. 


Some host computers automatically include a line feed 
when they echo or send the return character, so that pres- 
sing the Rtn key moves the cursor down one line and to the 
left margin. If your host does not, you can use the setup 
command CRLF (explained in Section 6) to cause the termi- 
nal to include a line feed with the return character. 


In Setup mode, the terminal automatically provides a car- 
riage return and line feed when you press the Rtn key. 


The Esc Key. When you press Esc, the terminal sends 
the escape character when it is communicating with a host 
computer. 


The escape is the first character in a special command 
sequence called an escape sequence. Appendix C lists the 
escape sequence commands. For detailed explanations of 
all escape sequence commands, see the 4//0 Series Host 
Programmers Reference Manual. 


The Tab Key. The Tab key transmits the horizontal tab 
character. 


Depending on how your host treats this character, it can 
cause the cursor to move a Certain number of spaces to the 
right. 


When the terminal is in Local mode, the cursor moves one 
character to the right each time you press the Tab key. 
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The Ctrl Key. Some control characters are used often and 
have their own keys, such as Rtn and Line Feed. Others, 
however, do not. You can transmit any control character by 
holding down the Ctrl key while you press another key. 


For example, press Ctrl and the G key (Ctrl-G) at the same 
time to send the ASCII Bel character, which causes the 
terminal bell to sound; Ctrl-M sends a carriage return char- 
acter, causing the cursor to return to the left margin; Ctrl-J 
sends the line feed character, causing the cursor to go down 
one line. 


The Shift ey. Most keys have two meanings: an unshifted 
meaning and a shifted meaning. 


When you press the key labeled W while holding down the 
Shift key, the terminal sends the uppercase character W; 
pressing the same key without the Shift (if the Caps Lock 
key light is not on) sends the lowercase letter w. Some keys 
are labeled with two non-alphabetic characters, one above 
the other. For example, press the key labeled 5 to transmit a 
5; press the same key and the Shift key to send the percent 
(%) character. 


Programmable function keys and the non-programmable 
command keys can also have shifted and unshifted mean- 
ings, as explained under the headings Command Keys later 
in this section. 


The Shift key is also used at the same time as the Ctrl key to 
send some control characters. 


The Break Key. The Break key (Figure 2-12) can be used to 
interrupt communications from some host computers to the 
terminal. It does not actually send a character to the host; 
instead it alters the state of the communications line so that 
the computer stops sending information to the terminal or 
stops the execution of a program. 


aS aa 


Before using the Break key, or the BREAKTIME 
command, find out how the host computer handles 
the interrupt. An unexpected Break signal could 
cause program failure or equipment damage. 
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The length of time that the interrupt lasts is important to 
some host computers. You can use the setup command 
BREAKTIME to specify the length of the interrupt sent by 
the terminal to the host, or to disable the Break key, as 
explained in Section 5. 


It is also important to know that various host computers 
react differently when they receive the Break. One host 
might stop the execution of a program while another might 
log you off and break the communications link to the termi- 
nal. Therefore, before using the Break key or BREAKTIME 
command, you should find out how the interrupt is handled 
by your host. 


Pressing the Break key also unlocks the keyboard (see 
Kybd Lock earlier in this section). 


COMMAND KEYS 


There are six command keys (Figure 2-13) that perform 
special functions or put the terminal into a particular mode 
of operation. These keys cannot be programmed to do any 
other function. Their purpose is to allow you to easily access 
frequently used terminal features. 


The eight command keys are: 
@ Page 

@ Caps Lock 

@ SET UP 

@ DIALOG 

@ CLEAR 

@ LOCAL 

@® CANCEL 

@ COPY 


Page 


When you press the Page key, the following items are 
erased: 


® Graphics in the current view that are not part of a graph- 
ics segment (a graphics segment is a picture or part of a 
picture that can be manipulated by terminal commands). 


@ Text that is not part of a graphics segment and not in the 
dialog area. 


BREAK 


~ AGG5-17 


Figure 2-12. The Break Key. 


2-14 REV, JAN 1984 4115B OPERATORS 


The following are erased momentarily and then redrawn 
when you press the Page key: 


oO Segments visible in the current view. 
© The framing box. 


© Border around a viewport. 


A segment is permanently erased by being deleted from the 
terminal’s memory. A segment can also be made invisible 
(not erased from the terminal's memory, but not visible on 
the screen). After a segment has been deleted, you may still 
need to press Page to erase its image from the screen, 
depending upon how the terminal’s FIXUP parameter is set 
(see Section 6). 


If the dialog area is nor enabled, the following actions occur 
when you press Page: 


© The cursor returns to the home position (the upper-left 
corner of the screen). 


© The terminal goes into alpha mode (that is, it interprets 
all incoming data as alphanumeric data, not graphic 
data). 


CONTROLS, iNDICATORS, AND KEYBOARD 


2 4010 Series Graphics Input (GIN) mode is terminated. 


Because of these actions, it is generally best not to press 
Page while a program is running with the dialog area dis- 
abled. (These actions do not take place if the dialog area is 
enabled.) 


Caps Lock 


The Caps Lock key is similar to the Shift Lock key ona 
typewriter. 


When you press Caps Lock, the red light in the key comes 
on and alphabetic characters are transmitted in upper case. 
The Caps Lock does not cause the uppercase version of 
numeric, command, or function keys to be transmitted. 


Especially useful on host systems that do not accept lower- 
case alphabetic characters, Caps Lock allows you to easily 
send only uppercase alphabetic characters to the host, but 
still allows you to conveniently send numeric characters 
rather than special symbols. 


CAPS 
LOCK 


4665-18 


Figure 2-13. The Command Keys. 
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SET UP 


When you press the SET UP key, the light in the key turns 
on and the terminal enters Setup mode. (If the dialog area is 
enabled, the light in the DIALOG key also turns on. See the 
discussion of the dialog area later in this section.) With the 
terminal in Setup mode, you can enter English-like com- 
mands (called setup commands) directly to the terminal. You 
can also enter escape sequence commands that would 
normally be sent from the host. 


Setup commands allow you to establish the terminal’s oper- 
ating environment and to use peripherals attached to the 
terminal. Setup commands are used for such things as 
establishing communication rates, inquiring about the ter- 
minal’s status, determining what kinds of errors the terminal 
should display, and programming special meanings 
(macros) into keys. 


The results of many setup commands are stored in setup 
memory. Specifications stored in setup memory are remem- 
bered even if the terminal is turned off or unplugged. 


Section 6 describes Setup mode and all of the setup 
commands. 


DIALOG 


Part of the screen can be used to display your conversa- 
tions (dialog) with the terminal and the host computer. This 
portion of the screen is called the dialog area. The DIALOG 
key can be used to make the dialog area visible or invisible. 


However, the dialog area interacts with other command 
settings. A more complete discussion of the dialog area is 
therefore given here. 


The text that can be written in the dialog area includes: 
@ The terminal’s error messages. 
@ Commands entered in Setup mode. 


® Text entered in Local mode (most commands entered in 
Local mode are not echoed on the screen). 


@ Non-graphics (alpha) text included in a graphics 
program. — 


@ Host-generated messages, such as prompts, warnings, 
and error messages. 


@ Normal terminal/host communications. 


See the explanation of the CLEAR key later in this section 
for details on how to clear text from the dialog area. 


Enabling the Dialog Area. Text is directed to the dialog area 
when the dialog area is enabled. When the dialog area is 
disabled, text is displayed with graphics. The DAENABLE 
command is used to enable or disable the dialog area. As 
illustrated in Figure 2-14, if the dialog area is enabled, the 
text is directed to the dialog buffer. The dialog buffer can be 
thought of as a scroll, part of which is displayed at a speci- 
fied screen location. 


Whether the dialog area is enabled is stored in setup mem- 
ory. For example, if you enable the dialog area and turn the 
terminal off, it will be enabled the next time you turn the 
terminal on. 


Figure 2-14. Enabling the Dialog Area. 
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4010 Compatibility. The terminal can distinguish between 
text that is part of the graphics (graphics text) from text that 
is not part of graphics (alpha text). Graphics text, such as 
titles and labels, is displayed with the graphics. Alpha text is 
sent to the dialog area. Programs written for 4010 Series 
and 4020 Series Tektronix terminals can also be run on this 
terminal, but special consideration must be made for text 
since those terminals do not have a dialog area. 


For example, you can run a program that was originally 
written for a 4010 terminal. If the program includes text 
(such as a title or labels) and the dialog area is active, the 
terminal will strip the title and labels out of the picture and 
display the text in the dialog area. 


When the dialog area is disabled, the terminal does not 
intercept text and display it in the dialog area. The DAEN- 
ABLE command allows a 4010-style program with text to 
execute on this terminal just as on a 4010 Series terminal. 


Dialog Area Visibility. Even if the dialog area is enabled, it 
must also be made visible so you can see the text that is 
sent to it. If the dialog area is enabled but not visible, dialog 
is written in the dialog area but neither the text nor the cur- 
sor is visible. 


The DIALOG key is used to make the dialog area visible or 
not visible. When the red light in the Key is off, the dialog 
area is not visible. (You can also use a setup command 
called DAVIS to make the area visible or not visible — 

see Section 6.) 


If the dialog area is enabled when you turn on the terminal, 
the light in the DIALOG key turns on, the dialog area is 
visible, and the cursor is displayed in the dialog area. If the 
dialog area is not enabled when you turn on the terminal, 
the dialog area is not visible and the cursor appears in the 
upper-left corner of the screen. 


Dialog Buffer. Text sent to the dialog area is stored ina 
special area of terminal memory called the dialog buffer. 
The DABUFFER command allocates a certain amount of 
the terminal’s memory for the dialog buffer. The factory 
default is 34 lines. 


When the dialog buffer is full, the first line is deleted so 
another line of dialog can be added to the end. 


The maximum length of each line is specified by the 
DACHARS command. 


Visible Portion of the Dialog Area. It is not usually neces- 
sary or desirable to have the entire dialog buffer visible. The 
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DALINES setup command specifies the number of visible 
lines in the dialog buffer. The factory default is five lines. 


When the dialog area is visible, you can use the top 
thumbwheel (Figure 2-9) to move (scroll) through the dialog 
area to observe its entire contents. As you scroll, you are 
moving the window, shown in Figure 2-14, so that different 
lines in the dialog area are visible. The window is that por- 
tion of the scroll that can be seen in the dialog area. The 
cursor stays on the line below the last line of dialog. This 
assures you that information sent to the dialog area while 
you are examining it does not overwrite information that is 
already there. 


If you want to scroll quickly to the beginning or end of the 
terminal’s dialog window, “flick” the top thumbwheel either 
up or down. Draw your index or middle finger down the 
center of the top thumbwheel, with a quick sharp stroke; this 
jumps you to the bottom of the dialog window. To jump to the 
top of the dialog window, flick your finger across the top 
thumbwheel in the other direction, away from you. 


Line Length. The maximum length of each line in the dialog 
area is specified by the DACHARS setup command. The 
factory default is 80. 


Dialog Area Writing Viode. The DAMODE setup command 
specifies whether a character In the dialog area is overwrit- 
ten or erased when you backspace the cursor, and whether 
a new space or underscore character will replace a charac- 
ter already displayed at that location. The factory default is 
Replace. Replace means that when the dialog area is 
enabled and visible and you backspace over a character, it 
is erased. The other setting is Overstrike. Overstrike means 
that when the dialog area is enabled and visible, backspac- 
ing over a character leaves the character unaltered. Enter- 
ing a space or underscore character leaves the old 
character at that location. 


A special character delete key is used to backspace in Setup 
mode. See the EDITCHARS command in Section 6. 


Dialog Area Position. You can position the dialog area 
anywhere on the screen. The DAPOSITION command 
specifies the location of the lower-left corner of the dialog 
area. The terminal positions the last visible line of the dialog 
area as close as possible to that location. 


For example, the factory default position is the lower-left 
corner of the screen (0,0). This means that the dialog area is 
located so that the last visible line (the fifth line, by factory 
default) begins at the lower-left corner of the screen. 
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CLEAR 


To erase the dialog area, press the SHIFT and DIALOG/ 
CLEAR keys at the same time. This clears all text from the 
dialog buffer. The result is that the dialog area is erased. It 
does not erase any graphics on the screen or affect whether 
or not the dialog area is visible. 


LOCAL 


When you press LOCAL, the red light in the key turns on 
and the terminal enters Local mode. If the terminal is 
already in Local mode, pressing the keys turns the light off 
and terminates Local mode. 


In Local mode, communications to and from the host com- 
puter are temporarily suspended. Everything typed at the 
keyboard is interpreted by the terminal as if it came from the 
host. Information or data received from the computer is not 
processed; it is put into a queue and processed when you 
exit from Local mode. 


Figure 2-15 illustrates the flow of communications. Notice 
that when the terminal is in Local mode, data transmission 
is routed back to the terminal instead of being sent to the 
host. 


In Local mode, you can enter commands (escape 
sequences) from the keyboard in the same format that a 
host uses and the terminal executes them as if they came 
from the host. 


If both Setup and Local modes are active, Setup takes 
priority. | 


CANCEL 


Press the Shift and LOCAL keys at the same time to initiate 
a CANCEL operation. ACANCEL operation: 


® Halts all disk, host, and 3PPI file copy operations except 
spooling (Section 6). 


@ Terminates segment operations. 

@ Cancels Bypass mode (BYPASSCANCEL in Section 6). 
® Terminates Graphics Input (GIN) mode (Section 4). 

@ Unlocks the keyboard (LOCKKEYBOARD in Section 6). 


If a file transfer is cancelled (COPY in Section 6), the file is 
closed. All information in that file operation up to the time of 
the CANCEL command is preserved. 


HARD COPY 


The HARD COPY key is used to make hard copies of the 
screen display when a compatible copier is attached to the 
terminal. To ensure good quality copies, allow the copier to 
warm up for a few minutes before copies are made. 


The exact length of time it takes to make a hard copy of the 
screen depends on the type of hard copy unit, but a typical 
time is about ten seconds. Data sent to the terminal during a 
hard copy operation is stored in the terminal’s input queue 
until the copy is finished. Data transfer operations and other 
non-display terminal functions continue undisturbed during 
a hard copy operation. 


HOST 


COMPUTER 


Figure 2-15. Communication Flow in Local Mode. 
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The standard terminal can make black and white copies of 
the screen on a TEKTRONIX 4634 or 4632 Hard Copy Unit 
with Option 15. The 4634 and 4632 make gray-scale copies 
with each color mapped to a particular gray level. (See the 
CMAP command in Section 6 for details on this mapping.) 
See Section 3 for details on using a monochrome copier. 


Pressing the HARD COPY button copies the display just as 
it appears on the screen (with black copying to black, etc.). 
Pressing Shift-HARD COPY (hold down the Shift key while 
you press the HARD COPY button) produces a reverse video 
image, with black copying to white and vice versa. This 
gives dark letters on white copy paper, similar to typewriter 
copy. The mapping of colors to gray levels is unaffected. 


You can also copy the screen by pressing the COPY button 
on the hard copy unit. 


With Option 09, the 4691 Color Graphics Copier Interface, 
installed and a 4691 copier attached to the terminal, you 
can make color hard copies of the screen by pressing the 
HARD COPY key. See the HC command descriptions in 
Section 6 (HCCOPIES, HCINTERFACE, etc.) and Section 3 
for details on making color hard copies. 
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FUNCTION KEYS 


Most of the terminal’s keys are programmable. This means 
that you can define the character or character string that is 
transmitted when you press a particular key. The character 
string or individual character assigned to a key is called a 
macro. 


The eight programmable function keys (Figure 2-16) trans- 
mit nothing unless they are programmed. The alphanumeric 
and control keys have characters assigned to them, but 
they can be assigned a macro instead. 


Most keys can have two macros (shifted and unshifted). 
Keys that do not have a shifted version can have just one 
macro. A few Keys are reserved for specific commands and 
cannot be programmezd. Figure 2-17 shows the keys that 
are not programmable and keys that have no shifted 
version. 


The DEFINE setup command (see Section 6) is used to 
program a macro into a key. When you press a key that has 
a macro programmed into it, the key is expanded to mean 
that macro. 
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Figure 2-16. Programmable Function Keys. 
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When the terminal is reset or turned off, macros are deleted The PAN and ZOOM keys put the terminal into Framing 
from the terminal’s memory. The DEFINE command can mode. There are several additional functions, as indicated 
also be used to delete a macro and return a key to its origi- by the labels on the other viewing keys: VIEW, OVERVIEW, 
nal meaning. NORMAL, NEXT VIEW, RESTORE, and BORDER. 

The terminal’s display can be divided into as many as 64 
VIEWING KEYS separate views. When there is more than one view, graph- 

ics actions (such as Graphics Input and Framing mode) take 
The terminal's four viewing keys (Figure 2-18) allow you to place in the view that is currently active. The current view 
examine a graphics display stored in segments in more can be selected by program control or by pressing the termi- 
detail. nal’s NEXT VIEW key. 


2-20 


NOTE 


The viewing keys are disabled automatically in 
Setup mode. If the bell rings when you press any of 
the viewing keys, they have been disabled by the 
terminal's lock-viewing-keys command. To unlock 
the viewing keys, put the terminal into Setup mode 
and enter the following escape sequence commana: 


EcRJ OCR 


Escape sequence commands are explained in detail 
in the 4110 Series Command Reference Manual, 
and listed in Appendix C of this manual. 


Appendix F has an example of how to use the viewing keys. 
To better understand the function of all the keys, do the 


Figure 2-18. The Viewing Keys. examples in Appendix F. 


COMMAND KEYS 


Page 


Ctrl 


VIEWING KEYS 


Caps Shift Break 
Lock | . 
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Figure 2-17. Non-Programmable Keys. 
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Framing Mode 


When you press the ZOOM or PAN keys, the terminal enters 
Framing mode. In Framing mode, a framing box appears at 
the edges of the currently active viewport. You can change 
the location or shape of the framing box with the thumb- 
wheels. The box frames that portion of the view you want to 
see in more detail. 


To view a small portion of the image currently displayed, use 
ZOOM. You can use the PAN key to move the framing box 
across or up and down the current view. These keys are 
discussed in detail under the heading ZOOM and PAN. 


The terminal’s screen resolution is 1280 x 1024 pixels, 
although the terminal’s internal coordinate space can 
address over 4 billion x 4 billion points along each coordi- 
nate axis. Because of this high internal data resolution, you 
can zoom in on a small portion of graphics and then display 
that portion without losing detail or sharpness. 


VIEW 


The VIEW key is used to update the view defined by the 
framing box that was formed by the PAN and ZOOM keys. 
When you have positioned the framing box outline to where 
you want it, press the VIEW key to update the display. The 
viewport is erased and the portion of the window that was 
within the framing box is displayed in the new viewport. The 
framing box again appears at the edge of the viewport. 


If you press Ctrl and VIEW at the same time, the view 
described by the framing box Its displayed in the viewport 
with the previous view. However, the framing box remains 
active in the current viewport. 


For example, you might have two viewports defined on the 
screen, the larger of the two containing a picture. You can 
Zoom into a small portion of the picture and press Ctrl-VIEW 
keys. The specified detailed view is displayed in the smaller 
viewport. This provides a detailed view as specified, but 
also leaves an overview of the larger picture visible. The 
framing box continues to be active in the current (larger) 
viewport. 


ZOOW and PAN 


Pressing either the ZOOM or PAN keys makes that function 
active. The light in the key turns on to indicate that you are 
in Framing mode with the pan or zoom function selected. 
When the zoom function ts active, the lower-left and upper- 
right corners of a rectangle appear in the framing box. The 
framing box represents the proposed new view (window). 
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lf you press ZOOM and rotate the top thumbwheel up and 
the bottom thumbwheel to the right, the height and width of 
the framing box increases (zooms cut). If you rotate the 
thumbwheels in the opposite direction, the height and width 
of the framing box decreases (zooms in). In both cases, the 
framing box maintains its current aspect ratio. 


You can zoom in to 1/16th the size of the current window, or 
pan to the edge of the terminal space. If you want to zoom in 
more than that, press the VIEW key and then zoom in on 
that view. 


If you press the PAN key, the framing box is replaced by a 
crosshair. The thumbwheels move the box right, left, up, or 
down, in the current view. 


You can pan until the edge of the framing box reaches the 
edge of the terminal space (4096 x 4096) or until only Ye of 
the framing box is still in the current view, whichever hap- 
pens first. lf you have not reached the edge of the viewport 
and you want to pan more, press the VIEW key to update 
the current view and pan across that view until you have the 
view you want. 


You can zoom in on a view until it is about eight times its 
current size. If you want to zoom out more, press the VIEW 
key to update the viewport and then zoom out on that view. 


Terminate the pan or zoom function by exiting from Framing 
mode or by making the opposite function (pan or zoom) 
active. Exit from Framing mode by pressing the ZOOM key 
when the ZOOM key light is on. Press the PAN key to exit 
from the Framing mode when the PAN key light is on. The 
light in the key turns off as Framing mode is terminated. 


You can use both the zoom and pan functions before you 
update a view. For example, you could press the ZOOM key 
and zoom in, then press ZOOM again, and so on until you 
have the framing box located correctly. Then press the 
VIEW key. 


Panning and zooming occur in the currently active viewport. 
To pan or zoom in another viewport, use the NEXT VIEW 
key, as explained later in this section. 


Yo Change the Aspeci Ratio. While you are in ZOOM, 
press the Ctrl key and rotate a thumbwheel. This alters the 
aspect ratio of the framing box. Press Ctrl while you rotate 
the top thumbwheel to change the height of the box without 
affecting its width.Press Ctrl while you rotate the bottom 
thumbwheel to change the width of the framing box without 
affecting its height. To restore the original aspect ratio, 
press NORMAL. 
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See the explanation of the RESTORE key for information on 
restoring a previous view. 


Vernier Action. If you press the Shift key while you rotate 
the thumbwheels, the box or crosshair changes more 
slowly, which allows you to more precisely position the win- 
dow. This is called vernier action. Press the Shift and Ctrl 
keys to use the vernier while rotating the thumbwheels to 
change the aspect ratio. 


OVERVIEW 


When you press the OVERVIEW key (the Shift and PAN 
keys at the same time) the currently defined fu//l overview 
window Is made visible. If the pan or zoom function is 
active, it remains active and the framing box is visible. 


If you press the Crtl and OVERVIEW keys (Ctrl-Shift-PAN) at 
the same time, the currently defined partial overview win- 
dow is displayed. (Notice that this changes the aspect ratio 
from its normal 5:4 ratio to a 1:1 ratio.) If the pan or zoom 
function is active, it remains active and the framing box is 
still visible (in a 5:4 aspect ratio — even though the display 
uses a 1:1 ratio). To restore the normal view and aspect 
ratio, press the OVERVIEW key again. 


The escape command Set-Overview-Window defines the 
current full and partial overview windows. The overview 
window can be set to be the entire adressable coordinate 
space; the default overview window is the window 0,0 to 
4095,4095. (See the 47/0 Series Command Reference 
Manual.) 


NORMAL 


As mentioned earlier, you can change the aspect ratio of the 
framing box by pressing the Ctrl key while rotating a 
thumbwheel. 


If you then press the VIEW key, the view is updated with the 
same aspect ratio as the framing box. To cause the framing 
box to return to its normal (5:4) aspect ratio, press the 
NORMAL key (Shift and ZOOM keys at the same time). 


2-22 REV, JAN 1984 


NEXT VIEW 


When the display contains more than one viewport, the 
terminal internally identifies each viewport with an integer 
value. You can make the view with the next larger identifier 
active by pressing the NEXT VIEW key. 


You can make the view with the next smaller identifier active 
by pressing Ctrl the same time as the NEXT VIEW key. 


When a viewport becomes visible, a border around that 
viewport blinks once to indicate that it is active. You can 
then use the Framing mode and viewing key functions in 
that viewport. 


RESTORE 


The terminal remembers the last three views for each view- 
port. To restore the most recent view, press the RESTORE 
key. To restore the second most recent view, press 
RESTORE again. Press it a third time to restore the third 
most recent view. 


If you press RESTORE a fourth time, the terminal restores 
the view as it was before you altered it with a viewing func- 
tion. This original version of the view is not replaced when 
you press the VIEW key, as the three most recent views are. 
This means that you are always able to return to its original 
condition. 


If you press RESTORE a fifth time, you see the most recent 
view again. If you press it a sixth time, you see the second 
most recent view, and soon. 


You can immediately restore the original view (as it was 
before you altered it with a viewing function) by pressing 
Ctrland RESTORE at the same time. 


Since the three most recent views are saved, this list of 
views changes every time you press the VIEW key. 

For example, when you press the VIEW key: 

@ The third most recent view is deleted. | 


@ The second most recent view becomes the third most 
recent. 


® The most recent view becomes the second most recent. 
@ The current view becomes the most recent. 


@ The contents of the framing box becomes the current 
view. | | 
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DER 


You can cause the terminal to draw a border around the 
current viewport by pressing the BORDER key. If that view- 
port already has a border, pressing the key deletes the 
border. 


CONNECTORS 


Connectors for your terminal are located on the display 
unit’s rear panel and on the rear panel of the 4115B pedes- 
tal or the M4115B electronics module. Figure 2-19 shows 
connectors on the rear panel of the display. Figure 2-20 
shows the layout of standard and optional connectors on 
the 4115B pedestal; Figure 2-21 shows the layout of stand- 
ard and optional connectors on the M4115B electronics 
module. 


NOTE 


Figures 2-20 and 2-21 show a typical arrangement 
of standard and optional connectors on the 4115B 
pedestal and M4115B electronics module. The 
number and location of connectors depends on the 
options that are installed in your terminal. 
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Check with a qualified person concerning proper cabling 
and installation if your cables are not connected. 


The M4115B Computer Display Terminal comes with 10-foot 
display cables and a 9-foot keyboard cable so that you can 
position the display and keyboard a few feet away from the 
electronics module. 


y cauTion | 


CAUTION . 


ONS Oe a Oe ae ae ae ae ae 


Tf you move the electronics module even slightly, 
make sure that the floppy or hard disk drives are 
not active (that is, make sure there is no read or 
write operation in progress). If you accidentally 
bump the module while the drives are active, you 
may damage the drives and also the disks, resulting 
in lost data. To prevent this from happening, turn 
off the module before moving it. Always turn off 
the power when disconnecting any cables. 


If you decide to reposition the M4115B and you disconnect 
any cables, be sure to reconnect the cables correctly, or 
contact a qualified person to reconnect the cables. 
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DISPLAY UNIT CONNECTORS @ Mains fuse. This is the primary fuse for the display unit. 
Note that the pedestal and the electronics module have 

These connectors are located on the rear of the display unit their own fuses. See the following caution! To remove a 

(Figure 2-19): bad fuse, unscrew the cover on the fuse holder witha 

@ RED, GREEN, BLUE connectors. These connectors rn the fuse pops out when the cover 


accept color signals from the pedestal or the electronics 
module (via BNC cables) and route those signals to the 
proper circuitry in the display unit. 


@ Display controller connector. This accepts control signals CAUTION 
from the pedestal or the electronics module and routes 


those signals to the proper electronics in the display unit. 
The controller cable plugs into this connector and is 
secured with two wire clips attached to the connector. 


If a fuse burns out, it may indicate a serious fault in 
the terminal circuitry or in the AC power source. 
Find and correct the problem before replacing the 


© AC power connector. This accepts AC power from the Juse and turning the terminal back on! Call a quali- 
display unit power cord. On the 4115B, the POWER Jied service technician if you do not have the appro- 
switch on the front of the pedestal powers both the dis- priate training. 


play unit and the pedestal; on the M4115B, the POWER 
switch on the front of the electronics module powers both 
the display and the module. 


Figure 2-19. Connectors on the 4115B and M4115B Display. 
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Figure 2-20. Connectors on the 4115B Pedesial. 
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Figure 2-21. Connectors on the M4115B Electronics Module. 
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PEDESTAL AND ELECTRONICS MODULE 
CONNECTORS 


Most of the standard and optional connectors are grouped 
on small panels on the back of the 4115B pedestal or the 
M4115B electronics module. The layout of these connector 
panels is similar for the 4115B pedestal and the M4115B 
electronics module, but the actual layout on your terminal 
depends on the options installed in your terminal. 


Except for the pedestal’s keyboard connector, all connec- 
tors are located on the rear panel of the pedestal or the 
electronics module. 


Standard Connectors 


Figure 2-20A shows the locations of these standard connec- 
tors on the 4115B pedestal; Figure 2-21A shows the loca- 
tions of these connectors on the back of the M4115B 
electronics module. 


O The Keyboard Connector. On the 4115B terminal, the 
keyboard connects to the front of the pedestal by a coiled 
cable; on the (i4115B terminal, the keyboard connects 
to the rear of the electronics module by a non-coiled 
9-foot cable. Figure 2-22 shows the KEYBOARD connec- 
tor on both terminals. To attach the cable on either termi- 
nal, plug it in, and then secure it with the two screws 
provided. 


4115B OPERATORS 


CONTROLS, INDICATORS, AND KEYBOARD 


AC power connector. This connector accepts the female 
end of an AC power cord and supplies power to the ped- 
estal or electronics module. The display unit has a sepa- 
rate power cord, although power to the entire terminal is 
controlled by the main POWER switch on the front of the 
pedestal or electronics module. 


Mains fuse. This is the primary fuse for the pedestal or 
electronics module. Note that the display unit and the 
pedestal (or module) have separate fuses. See the pre- 
ceding caution! To remove a bad fuse, unscrew the 
cover on the fuse holder with a flat-blade screwdriver; the 
fuse pops out when the cover is removed. 


RED, GREEN, BLUE connectors. These three connec- 
tors supply color signals (via BNC cables) to the corres- 
ponding connectors on the rear of the display unit. 


TO DISPLAY connector. This connector supplies control 
signals to the corresponding connector on the rear of the 
display unit. The control cable plugs into this connector 
and is secured by the two wire clips attached to the con- 
nector. 


RS-232-C/V.24 connector. This connector provides RS- 
232 communications. This is normally used to connect to 
a host computer. 


TO HARD COPY connector. This connector provides 
output signals to a monochrome hard copy unit. 
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Optional Connectors 


Figures 2-20B and 2-21B show optional connectors on the 
pedestal and the electronics module, respectively. These 
connectors are present when the indicated options are 
installed in the terminal. 


QO MASS STORAGE INTERFACE (Option 45). This pro- 
vides data output to a mass storage device compatible 
with Option 45. 


REMOTE ON OUTPUT (Option 45). Supplies a Power 
On signal to the remote mass storage device. (See Sec- 
tion 3 for more information.) 


© 3-PORT PERIPHERAL INTERFACE (Option 10). This 
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panel provides three RS-232 connectors (labeled PORT 
0, PORT 1, and PORT 2) for interface with optional RS- 
232 peripheral devices. 


© TO 4690 SERIES COPIER (Option 09). This connector 
provides color signals toa TEKTRONIX 4691 Color 
Graphics Copier. 


O TABLET INTERFACE (Option 13 or 14). The 4115B ped- 
estal has an option panel containing three connectors for 
the tablet; the M4115B electronics module has a single 
tablet connector that connects to a tablet interface box. 


Section 3 contains more detail on some of the options and 
optional connectors. 
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Section 3 


FILic TRANSFERS AND PERIPHERALS 


INTRODUCTION 


The purpose of this section is to introduce the concept of a 
file and file transfers, and to show how you can use various 
peripherals attached to the terminal to store and display 
information. This section is introductory in nature. It con- 
tains concepts and command examples that an experi- 
enced operator may already know. For detailed information 
on each of the commands discussed here, see the com- 
mand descriptions in Section 6. 


This section is organized as follows: 


© Devices, Files and File Transfers 


Introduces files, devices, and file transfers, and gives a 
summary of the file transfer commands. 


Oo Using Disk Drives 
Discusses all disk drive options (42, 43, and 45). 


© Using the Three-Port Peripheral Interface 


Discusses the 3PPI (Option 10) and those instruments 
most often connected to it: plotters, printers, and tape 
drives. 
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© Using the 4691 Color Graphics Copier 


Discusses the use of Option 09 and the 4691 Color 
Graphics Copier to make color hard copies of the display. 


© Using a Monochrome Hard Copy Unit 


Discusses how to make black and white hard copies. 


© Using a Tablet Option 


Discusses Option 13/14 and the use of a graphics tablet. 


Each discussion includes a physical description of the 
option (if any) — the external indicators, controls, and con- 
nectors associated with the option, and any special instru- 
ment settings that may be necessary. Then asummary of 
the commands included in this option or most often used 
with the instruments is given. Finally, some examples of 
actual command sequences to accomplish a specified task 
are given. See Section 6 for an explanation of setup com- 
mand syntax. 
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FILES AND FILE TRANSFERS 


FILES 


One of the basic units of computer information is the file. A 
computer file is used in much the same way as a business 
or personal file — to collect and store items of information 
that are related in some way. Like business files, computer 
files have names, are difficult to handle when they get too 
large, sometimes need to be moved from one place to 
another, and sometimes need to be thrown away altogether. 


To a computer or terminal, a file is simply a stream of data 
that has a beginning and an end. The beginning of a file is 
marked by a file header that is automatically written when 
the file is created. The end of a file is marked during file 
transfer operations by an end-of-file string. This string may 
or may not be included in the file; when it is not, it must be 
explicitly supplied by either the hardware or software. You 
will see the end-of-file string referred to occasionally in this 
manual. 


Each file has a name and, on most computer systems, an 


extension. In 4110 Series terminals each file is identified by 


a name that is from one to eight characters long; it may 
have an extension from one to three characters long, sepa- 
rated from the name by a period. For example: 


MAY 15.DAT 
VITALDAT 
myfile.tx 
INITCMD 


A complete description of file name conventions is given in 
the File Names discussion near the beginning of Section 6. 
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FILE OPERATIONS 


The operations you may want to perform on a file depend on 
the contents of the file. For example, files that contain 
graphic commands to the terminal will be executed — that 

is, acertain part of the terminal will read the file and execute 
any terminal commands it contains. 


There are a few basic types of operations that apply to all 
types of files; you can transfer a file, find status information 
for a file, delete a file, rename a file, and write-protect or _ 
unprotect a file from being deleted or modified. 


Of these types of operations, file transfer. operations are the 
most important. Each file transfer locates a file on a speci- 
fied source device and transfers it to a specified destination 
device, perhaps modifying the file in some way during the 
transfer. Some examples are: 


@ Copying a file from a disk to a plotter, translating graphic 
commands that the terminal understands into graphic 
commands that the plotter can understand. 


® Copying a file from the host onto a disk. 


® Saving the terminal screen contents to a disk file for later 
plotting or execution. | 


As these examples show, there are many different 
“devices.” Some of them can both send and receive data (a 
disk drive, for example), some can send data only, and 
some are not really physical devices at all. The following is a 
list of the most common “devices” that you can specify as 
sources or destinations for file transfers. Note that the colon 
is always the last character ina device name. _ 
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The following devices can be either a source or a desti- 


nation device: 
HO: The host communications port (standard). 


FO: Flexible disk drive 0. (Options 42, 43) This 
is the default drive; if you specify a 
filename without a device name, device FO: 


is assumed. 
F1: Flexible disk drive 1. (Option 43) 
SO: — S7: 
TO: — T7: 
U0: — U7: 
VO: — V7: \ External mass storage devices (Option 45) 
Wo: — W7: (( and hard disk drives (Options 46 and 47)’ 
XO: — X7: 
YO: — Y7: 
Z0: — Z7: 


The Option 10 peripheral ports may be sources or desti- 
nations or both, depending on what type of peripheral is 
attached. For example, a printer is a receive-only device, 
so specifying PO: as a source is invalid if a printer is 
attached to that port. Port device names are: 


PO: Port 0 
P41: Port 1 
P2: Port 2 


The “device” SC: specifies the screen contents. Specify- 
ing this as the source device allows you to transfer the 
contents of the display using the same command format 
as for other file transfers. SC: cannot be used as a desti- 
nation. (Requires Option 09; see the COPY command 
description in Section 6.) 


The “device” HC: specifies a hard copy unit as the desti- 
nation device. Even though making a hard copy is not 
Strictly a “file transfer,” this allows you to make hard 
copies using the same command format as for other file 
transfers. (Requires Option 09; see COPY and SPOOL 
command descriptions in Section 6.) 


The “device” DM: specifies the DMA interface. Devices 
DS:, SG:, PX:, and CM: specify DMA “pseudo devices” 
(see the 47/5B Option 3A DMA Interface Instruction 
Manual). 


j 
The specific device names for an Option 45, 46, or 47 device depend on strap 
settings that are set during installation. 
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There are several different commands that you can use to 
transfer a file, each designed for a particular purpose. A 
summary of the file transfer commands is given in Table 3-1. 


Command 


COPY 


LOAD 


PLOT 
(Option 10) 


SAVE 


SPOOL 


STOP 
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Table 3-1 
FILE TRANSFER CONMANDS 


Description 


COPY makes a copy of a specified file, leaving the 
original file intact. The copy may have a new name, 
extension, or device location. Useful for moving files 
or making backup copies. While a COPY is in 
progress the terminal will not execute any other 
commands. 


LOAD reads a file and executes any terminal 
commands it contains. Useful for initializing the 
terminal or redrawing graphics stored on disk. 


PLOT copies the visible segments on the display to 
an output device. It is specifically designed to plot 
the screen contents on a 4662 or 4668 plotter. 


SAVE sends commands necessary to recreate 
certain items on a destination device. These items 
include macro definitions, graphic segments, and 
specified parts of the screen display. A SAVEd file 
can be retrieved and executed by the LOAD 
command. 


SPOOL is designed for “background” copy 
operations between peripheral devices. ASPOOL 
operation allows normal terminal display and host 
communications to continue uninterrupted. 


STOP halts a spooling operation in progress, closes 
the output file and saves all information already 
stored in it. 
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USING DISK DRIVES Option45 The Mass Storage Interface. This option pro- 
vides the ability to interface to one of the fol- 

A disk drive is one of the most common ways to store large lowing external devices: 

quantities of information. Disks are small and relatively 

inexpensive, and information can be retrieved quickly from @® The TEKTRONIX 4926, a 10-megabyte 

anywhere on a disk medium. hard disk. 

The terminal has five options that provide information stor- @® The TEKTRONIX 4926 Option 25, a 

age on a disk media: 10-megabyte hard disk with dual 5%- 


| inch flexible disk drives. 
Option 42 One flexible disk drive, mounted in the pedes- 


tal or electronics module. Includes the Mass @® The TEKTRONIX 4926 Option 26, dual 
Storage Interface. 10-megabyte hard disks. 

Option 43 Two flexible disk drives, mounted in the pedes- @ The TEKTRONIX 4925, dual 5%-inch 
tal or electronics module. Includes the Mass flexible disk drives. 


Storage Interface. 

Option 46° One 10-megabyte hard disk, mounted in the 
pedestal or electronics module. Requires 
either Option 42 or 45; cannot be used with 
Option 43. 


Option 47’ Two 10-megabyte hard disks, mounted in the 
pedestal or electronics module. Requires 
either Option 42 or 45; cannot be used with 
Option 43. 


2 
M4115B only. 


Figure 3-1. Option 42/43 Flexible Disk Drives. 
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OPTION 42/43 DESCRIPTION 


Option 42 provides one disk drive for 8-inch removable 
flexible disk storage media and a Mass Storage Interface to 
an external mass storage device (disk). Option 43 provides 
two such drives; otherwise it is identical to Option 42. Figure 
3-1A shows the Option 42/43 drive in the 4115B pedestal; 
Figure 3-1B shows the drive in the drawer of the M4115B 
electronics module. Each drive includes a door, a door bar 
with a disk drive indicator, and a write-protect switch and 
light. 


The drive on the right is always Drive 0. In setup commands, 
specify the right disk drive as device FO: (always include the 
colon in a disk drive specification). The left disk drive, if 
present, is Drive 1 (Specified as F1: in setup commands). 


The following discussions supply basic information on 
safety and handling of flexible disks. 


BACK 
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Basic Description 


Each flexible disk (Figure 3-2) consists of a thin circular disk 
of plastic coated with a metal oxide to hold magnetic 
charges. The magnetic pattern on the disk can be altered 
(written) or detected (read) by the read/write heads in the 
disk drive. The disk itself is permanently enclosed in a sleeve 
that protects the disk surface from dirt, scratches, and other 
damage. The sleeve has openings for read/write opera- 
tions, for the disk drive spindle, etc. Each disk has a front 
and a back side; the disk label is on the front of the disk. 


Each disk/sleeve assembly is shipped in a protective enve- 
lope that is open on one side. This envelope covers approxi- 
mately three fourths of the disk/sleeve to protect the 
exposed portions of the disk. 


Figure 3-2. Flexible Disks. 
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Inserting and Removing a Disk 


The disk drive(s) for the M4115B terminal are 
located in a drawer in the electronics module. Open 
the drawer gently before removing or inserting 
flexible disks. To prevent damage to the drives and 
disks, do not let the drawer slam shut; close it care- 
fully. (If the drive is reading or writing to a flexible 
or hard disk and you accidentally bump the drawer, 
the drive and/or disk can be damaged.) To avoid 


damage, keep the drawer closed when you are not 
changing disks. 


To insert a disk, open the door to the drive by pressing in on 
the door bar. Insert the disk, notched edge first, with the 
label as shown in Figure 3-3. Slide the disk all the way in, 
until it stays in; do not push so hard as to bend the disk. 
Then push down on the drive door until it clicks into place. 


To remove a disk, push in on the door bar. When the door 
opens, the disk pops out for easy removal. 


Do not remove a disk while the disk drive indicator 
is on. The light indicates that the disk is currently in 
operation. Removing a disk halts the operation in 


progress, and could damage or destroy data on the 
disk. 


Always remove an ejected disk entirely from the 
drive. The drive spindle mechanism can damage the 
surface of a disk left partially inserted in the drive. 


Handling a Disk 


Flexible disks are easy to store and handle. However, it is 
important to take a few simple precautions to prevent dam- 
age to the disk and to ensure the integrity of data stored on 
the disk. 
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Figure 3-3. Inserting A Disk. 
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Do not bend a disk, since the disk can crease or tear, ren- 
dering it unusable. Oil, dirt, or dust on the disk can cause 
scratches or other problems when the read/write heads in 
the disk drive access that disk area. Touch only the paper 
sleeve that encloses the disk itself. When a disk is not in 
use, keep the disk in the protective envelope to prevent 
damage to exposed disk areas. 


Store all disks in an area protected from dust and extreme 
temperatures. Temperature range should be between 
+ 50°F and + 122°F. Prolonged exposure to extreme heat 
(above 122°F) or cold (below —40°F) can ruin the disk. 


Before using a disk, leave it in the area of the disk drive for 
at least five minutes before inserting it into the drive. This 
will prevent unnecessary stresses on the disk or errors in 
information access due to sudden environmental changes. 


If you are storing critical data on a disk, make a backup 
copy of the disk periodically (perhaps at the end of each 
working day). This will protect your data in case of fire or 
accidental destruction of the disk. In fact, simply for conven- 
ience and to minimize the cost of restoring lost data, back- 
ing up a disk periodically is good practice. 


Each disk should last for about 3,500,000 read/write opera- 
tions per track, or about 30,000 insertions, whichever 
comes first. When the disk begins to wear, you will see 
translucent rings around the edges of the disk surface 
through the openings in the disk sleeve. You will also notice 
repeated errors when you try to access portions of the disk. 
When this happens, discard the worn disk and use the 
backup. 


Write-Protecting a Disk 


There are three ways to protect information on a disk from 
being accidentally deleted or overwritten by other data. 


1. When the WRITE PROTECT switch (Figure 3-1) on the 
disk drive is on, the light in the switch lights up and the 
entire disk in the drive is write-protected. You cannot 
format the disk, delete or add files, or add information 
to files on the disk. If you attempt any operation that 
would change the data on the disk, an error results. 


2. Youcanuse the setup command PROTECT to protect 
individual files on a disk. This command prevents delet- 
ing and writing to a particular file; you can still copy the 
file or destroy it by reformatting the disk. 
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3. Some disks also have a write-protect notch. On an 8” 
floppy disk, when the notch is exposed, you cannot 
write to the disk. (The disk is write-protected.) To unpro- 
tect the disk, cover the notch with opaque tape. (The 
5%" floppy disks, on the other hand, are write-pro- 
tected when the notch is covered and unprotected 
when the notch is exposed.) 


MASS STORAGE INTERFACE DESCRIPTION 


The Mass Storage Interface (Option 45) provides the termi- 
nal with an interface to: 


O The TEKTRONIX 4926 Hard Disk Drive 


oO The TEKTRONIX 4925 (or 4926 Option 25) Dual 5%-Inch 
Flexible Disk Drives 


© The Option 46 Single Hard Disk Drive or Option 47 Dual 
Hard Disk Drives (M4115B only) 


Options 46/47 are internal mass storage devices; they are 
built-in drive(s) in the drawer of the M4115B’s electronics 
module. The 4926 and 4925, on the other hand, are external 
mass storage devices to the 4115B or M4115B terminals. 


The 4926 and Option 46/47 Hard Disk Drives use 5%-inch 
rigid Winchester disk technology. These disks are not 
removable. The closer tolerances possible with a fixed disk 
permit much greater storage Capacity than on removable 
disks of the same size. 


The 4925 Flexible Disk Drives use 5%-inch removable 
flexible disks. The same considerations of handling and 
safety apply to these disks as to the 8-inch disks discussed 
earlier. 


The Option 45 panel is located on the rear of the pedestal or 
electronics module (Figure 3-4). It contains two connectors. 
The MASS STORAGE INTERFACE connector accepts an 
MSIB cable from the storage device. The REMOTE ON 
OUTPUT connector supplies a power-on signal to an exter- 
nal storage device, so that power is automatically applied to 
the device when you power up the terminal. 


If you are using Option 45 to interface the terminal to an 
external device (Such as a 4926 or 4925), use the REMOTE 
ON OUTPUT connector to control power to the device. If 
you do not connect an external device with the terminal’s 
REMOTE ON OUTPUT connector, be sure that you: 


© Cap the device’s unused remote connector with a short- 
ing cap. (The 4926 and 4925 are supplied with a shorting 
cap for this purpose.) 


© Power up the connected device before you turn on the 
terminal. 
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Figure 3-4. Option 45 Rear Panel Connectors. 
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lf you do not cap the connector and you power up the device 
first, the terminal may not recognize that an external device 
is indeed connected, or the device may lock up and not 
respond to instructions from the terminal or the host. 


DISK DRIVE COMMAND SUMMARY 


Table 3-2 presents a summary of the setup commands tnat 
relate to general disk drive operation. Section 6 contains 
detailed descriptions of device and file name conventions 
and the individual commands. in general, anytime you can 
specify a disk mounted in the terminal, the command syntax 
allows an Option 45 device as well {assuming tne option Is 
installed and a storage device is attached). 


" ARAN PRS ONT PNT EU = MP ANVIGOAL 
Suit Am Y wy Dios eke yo COMMANDS 


Command Description 


Copies a file from one device to another. (Original 
is left intact.) 


Deletes a file from the disk. 


DELETE 

DIRECTORY Creates a directory of a disk or of a single file. 

DISMOUNT Instructs the terminal that a disk has been 
changed. 

FORMAT Prepares a disk to store data. WARNING!! 
Formatting a disk destroys all data previously 
stored there. 

LOAD Reads a file from a disk into the terminal’s 
command processor; any terminal commands tn 
the file are executed. 

PLOT Sends information from the screen to an output 

(Option 10) device, encoding graphic information as escape 
sequences. 

PROTECT Write-protects or unprotects individual disk files. 

RENAME Renames a file. The location and contents of the 
file are unchanged. 

SAVE Saves selected information for later use by the 
LOAD command. 

SPOOL Copies a file from one device to another while 
allowing other terminal operations to continue. 

STOP Halts a spool operation. 

USERNUMBER | Sets a user number for file access. All disk 


operations (except FORMAT) access only 
information marked by the current user number. 
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XAMPLES OF USE 


rormatiing a Disk 


NOTE 


Tf you plan to use a hard disk with Local Program- 
mability, be sure to format the disk (using the /C 
argument) before you store any data on the disk. 
Read the following discussion and the description 
of FORMAT in Section 6 for more information. 


Refore a disk can be used to store data, it must be format- 
‘ed — that is, prepared to siore data. Information is stored 
on a disk in a certain physical arrangement invoiving tracks 
(concentric rings) and sectors (Subdivisions of tracks). Dur- 
ing formatting, address labels are written at the beginning of 
each track and each sector. Information is also written on 
the disk to synchronize the action of ihe read/wriie heads 
with the portion o7 the disk under the head, allowing the 
head to find the proper location. 


But most importantly for you, the operator, disk space is 
conceptually organized into blocks and directory entries. 
These terms do noi refer to physical paris of the disk, but 
how space on the disk is allocated to files that are created 
and modified. 


The number of directory entries is fixed for each type of 
disk. Each file requires at least one directory entry. A file 
may require more than one directory entry, depending on 
the file length; however, at least one is required. This means 
that the number of directory eniries is the maximum nuniber 
of files that you can store on one disk. The number of direc- 
tory entries depends on the storage capacity of the disk. 
See the FORMAT command description in Section 6 for 
details. 


When you add information to a file, the system allocates 
additional file space in predetermined sized chunks called 
blocks. The size of a block depends on the disk format and 
is listed whenever you do a DIRECTORY command for that 
disk (or a file on that disk). Typical block sizes are 1024 
bytes or 2048 bytes (characiers). 


Initially, when a file is created, one block ts allocated to the 
file. As you add information to the file, the size of the file is 
increased in one-block increments to allow for the added 
information. Using a block structure keeps the disk control- 
ler circuitry from having to update the file size continually, 
but keeps unused space in the file to a minimum by using a 
relatively small block size. 
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This information sounds rather technical, and you do not 
need to understand it to format and use a disk. But it will 
help you to interpret the directory messages that appear on 
the screen. See the DIRECTORY and FORMAT commands 
in Section 6 for details. 


With the exception of the Option 46/47 hard disks (for the 
M4115B terminal only), disks are not formatted at the fac- 
tory. You must therefore format a disk before using it. If you 
plan to use Local Programmability on a hard disk, be sure to 
format the hard disk using the /C argument (as described 
below) before you begin storing data on it. Even of you have 
an Option 46/47 hard disk that is already formatted, you 
must format it again for compatibility with Local Program- 
mability, before you begin using it. 


Formatting a disk destroys all data stored on the 
disk. Make sure you no longer need this data before 
you format the disk. 


To format a disk, insert the disk in the appropriate disk drive 
(for removable disks) and enter the FORMAT command. 
The simplest version of the command simply formats the 
disk in a fashion determined by the physical size and type of 
the disk. For example: 


FORMAT FO: 


To format a 10-megabyte hard disk to conform with the data 
format required by Local Programmability, include the string 
“IC” after the device name. For example: 


FORMAT S0:/C 


Finally, it is possible that certain tracks on a hard disk are 
known to be unreliable. (This information may be included 
with the disk when it is shipped from the manufacturer.) In 
that case you can format the disk to exclude those tracks 
from use by including up to five strings of the form “/track”’ 
in the device name, where “track” is a track number. For 
example, suppose you know that tracks 23, 29, and 37 are 
“bad.” If the disk is already in use and if it is necessary, 
make a backup copy of the data on the disk. Then format 
the disk with the command: 


FORMAT S0:/23/29/37 


This will prevent these tracks from being accessed, while 
allowing the rest of the disk to be used normally. 
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The USERNUMBER Command 


It is possible, especially on a high-volume fixed disk, that 
several users will share the same disk. In such cases, it is 
desirable to protect each user’s data from accidental dele- 
tion by other users. For example, suppose you have a file 
called MYDATA.NUM on the disk in device SO:. If another 
user of that disk decides to delete or create a file with the 
same name, your file could be destroyed. 


To avoid such problems, you can specify a user number for 
each user of the disk. Whenever a file is created on that 
device, the file is marked with the current user number. 
Most disk operations access only files marked with the 
current user number. For example, when you give a 
DIRECTORY command, only files marked with the current 
user number are listed. 


The terminal powers up with the user number set to zero. 
When you begin a work session, simply set the correct user 
number. For example, if your user number is 9, give the 
following command at the start of your work session: 


USERNUMBER 9 


Then COPY, DELETE, DIRECTORY, and similar commands 
will only access files marked with your user number, and 
any files created will be so marked. 


Changing a Disk 


NOTE 


Always use the DISMOUNT command before 
inserting a new disk in a flexible drive. If you don’t 
use DISMOUNT, a DIRECTORY or a read opera- 
tion of that disk may result in inaccurate entry and 
block information. 


When you change a new disk in a floppy drive (such as a 
4925 or Option 42/43 drive), you must notify the terminal 
with the DISMOUNT command. This instructs the terminal 
to scan the new disk for allocation and block information (for 
example, for the amount of free space and for bad track 
numbers) before accessing the disk. 


This command: 
DISMOUNT FO: 


notifies the terminal that the disk in drive FO: has been 
replaced. 
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Disk Directories 


One of the first things you may want to know about a disk is 
what information — what files — it contains. Simply give a 
DIRECTORY command with the appropriate device name; 
for example: 


DIRECTORY FO: 


This command prints a directory of the disk in drive 0 on the 
terminal screen. It also lists how many blocks on the disk 
have been used and how many are free (unused), how 
many directory entries are used and how many are free, and 
the disk block size. 


lf you want, you can output the directory to some other 
device than the terminal screen. Just include the keyword 
to, followed by a destination device. For example, the fol- 
lowing command sends a directory of the disk in drive 0 to 
an Output device (say a printer) attached to peripheral port O 
(Option 10): 


DIRECTORY FO: to PO: 


To use this form of the DIRECTORY command, you musi 
have an output device attached to Port 0, and Port 0 must 
be properly configured for the output device. See Using the 
Three-Port Peripheral Interface discussion later in this 
section. 


You can also save the directory by creating a file and storing 
it there; for example: 


DIRECTORY FO: to FO:FODIRECT 


This command creates a directory of the disk in drive 0 and 
stores it in a file cailed FODIRECT on the same disk. 
(Remember that filenames must be no more than eight 
characters long.) Note that the source device and destina- 
tion device are the same in this command. 
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Finally, you can ask for the directory of a specific file by 
including the filename in the source device: 


DIRECTORY FO:TESTDATA.NUM 


This command lists directory information for the file called 
TESTDATA.NUM on the screen. This information includes 
the length of the file in blocks and its write-protect status. If 
you want to copy a file to a disk but Suspect there may not 
be enough space on the disk, just do a directory of the file 
and of the disk to check whether there is sufficient room. 


As with all file commands, only files marked with the current 
user number are listed. The entry and block information, 
however, refers to the entire disk. 


Figure 3-5 shows a sample disk directory and a sample 
directory of an individual file. 


DRIVE FO: USER NUMBER 12 
~NAME PROTEC? 
PRACTICE EXE YES 

HAVE A NO 
GOOD Dar NO 
NEWDATA DAT NO 
INITIAL CMD TE 

~ENTRIES USED: 36 

-~ENTRIES FREE: 284 

~BLOCKS USED: 90 

=BLOCKS FREE: 218 

=BLOCK: toicbs 2048 

A 

DRIVE. 5FO% USER NUMBER 12 

-NAME BLOCKS PROTECT 
PRACTICE. EAE 32 ees) 

-ENTRIES USED: 6 

-ENTRIES FREE: 3414 

-~BLOCKS USED: s 32 

=BLOCKS “FREES ~ 276 

-BLOCK SIZE: 2048 

B 4665-27A 


Figure 3-5. Sample Directories. 
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Changing a File Name 


Sometimes you may want to change the name of a file, 
perhaps to use the old name for another file or because the 
status of the file has changed. To change a file name, use 
the RENAME command. 


For example, suppose you have been working on a file of 
tentative information called EXPER4.TMP. This file is on the 
disk in drive O and contains information on seismic tremors 
from Experiment #4. It has an extension of TMP since itis a 
“temporary” file. Now the experiment is complete and you 
wish to mark this file for statistical analysis. One way to do 
this is to rename the file: 


RENAME EXPER4.TMP TO QUAKE-37.DAT 


Drive 0 is the default device, so you need not specify the 
device in this command. 


Deleting a File 


When you no longer want to keep the information in a file, 
you can delete the entire file with the DELETE command. 


CAUTION 


Deleting a file destroys all information in the file. 
Be sure that you no longer need information in the 
Sile before you delete it. 


Only files marked with the current user number will be 
deleted. You must specify both the file name and the exten- 
sion for the file you want deleted. For example, to delete a 
file on device FO: called OLDDATA.PDQ enter the following: 


DELETE F0:OLDDATA.PDQ 
This command would not delete the following: 


OLDDATA 

OLDDATA.PDX 

OLDDATA.PDQ marked with a different user number 
OLDDATA.PDQ on another device 
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Protecting a File 


Earlier in this discussion you learned how to protect an 
entire disk from being changed by using the WRITE PRO- 
TECT switch on the disk drive. Sometimes you may want to 
protect a particular file from being accidentally deleted or 
written to, while allowing access to other files on the disk. To 
protect or unprotect a single file, use the PROTECT com- 
mand with the filename and one of the keywords yes or no. 
For example, to write-protect a file called VITAL.DAT on the 
disk in drive 0, enter either of the following: 


PROTECT FO:VITAL.DAT yes 
PROTECT FO0:VITAL.DAT 


The keyword yes is optional. To unprotect this file so you 
can write new information in it or delete it, enter the com- 
mand with the keyword no, like this: 


PROTECT FO:VITAL.DAT no 


Transferring Disk Files 


As Table 3-1 indicates, each file transfer command is 
designed for a particular purpose. In this discussion, sev- 
eral examples of transfers to or from a disk are given. 


COPY With Disk Files 


One of the most useful commands is the COPY command. 
It provides a general file transfer capability. For example, to 
copy a file from one disk location to another, just give the 
COPY command with the appropriate source and 
destination: 


COPY FO:NEWDATA.DAT TO $1:DATA37.DAT 
Note that you can change the file name when you copy it, 
and the old file is left intact. Here, the file NEWDATA.DAT is 
still on the disk in drive 0, and remains there until you delete 
it. Note also that FO: is the default device, so you could 
shorten this command to: 


COPY NEWDATA.DAT TO S1:DATA37.DAT 
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The destination disk and the source disk can be the same 
disk, as long as the file names do not conflict. For example, 
you cannot perform the following file copy: 


COPY FO:RESULTS TO FO:RESULTS 
However, you can do the following: 


COPY FO:RESULTS TO FO:RESULTS.SAV 
or 
COPY FO:RESULTS TO PERMDATA 


COPYing To and From a Host. The COPY command can be 
used to transfer files between the host computer anda 
device attached to the terminal. One use would be to copy 
an initialization file from the host to a disk file; this file would 
later be LOADed to the terminal to initialize it for a given 
applications task. For example: 


From host 
or keyboard 


EOFSTRING “/**/” 
COPY HO: to F0:INIT.CMD 


DEFINE < macro definition > 
DEFINE < macro definition > 


BAUDRATE < proper baud rates > 


PARITY < proper parity setting > From host 
(other initialization commands) 
/**/ {the end-of-file string) 

EOFSTRING } From host 


or keyboard 


This is a “model” of a copy from the host; an initialization 
file called INIT.CMD is created on the disk in drive 0, and 
various terminal commands are copied into it. (Note how- 
ever that commands from the host would be sent using 
escape sequence syntax.) 


The first EOFSTRING command sets the end-of-file string 
to /**/. The COPY command instructs the terminal to copy 
incoming data from the host port to a file called INIT.;CMD on 
the disk in drive 0. The DEFINE commands program 
selected keys with macro definitions. The BAUDRATE com- 
mand sets the data transmission rates to use. (These may 
vary with the application; a program that involves text edit- 
ing would not need to transmit data as fast as an interactive 
data analysis program in which large amounts of data were 
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transferred.) The line /**/ is the end-of-file string; this tells 
the terminal that the COPY operation into INIT.CMD is com- 
plete. The terminal ends the copy operation and closes the 
disk file. The next EOFSTRING command resets the end-of- 
file string to the null string; this allows the bit pattern that 
defines the string /**/ to be used for other purposes (per- 
haps as encoded graphic coordinates or integer parameters 
for some terminal command). 


If the source device is the host (HO:), you must begin the 
data transmission before entering the COPY command. 
Once you enter the COPY command the terminal waits for a 
data stream from the host until it receives an end-of-file 
string or until the CANCEL key is pressed. 


One way to arrange the proper sequence of events is as 
follows: 


1. Exit Setup mode and enter the host command to begin 
sending data, but leave out the host’s end-of-command 
character (typically a Carriage Return). 


2. Enter Setup mode. 


3. Enterthe COPY command with the desired destination 
device. 


4. Exit Setup mode. (The SET UP light stays on because 
the COPY command is still being executed.) 


5. Enter the host’s end-of-command character. (If your 
host uses remote echo, this causes the end-of-com- 
mand character to be the first character in the data 
stream.) 


Another way to do this is to program the host so that there is 
a delay between the time it receives the end-of-command 
character and the time it begins sending data. Make this 
delay long enough so that you have enough time after you 
enter the host send-data command to put the terminal in 
Setup mode, enter the COPY command, and leave Setup 
mode. The sequence would then be: 


1. Exit Setup mode (if necessary) and enter the send-data 
command to the host. 


N 


While the host delays, enter Setup mode and type in 
the COPY command with HO: as the source and the 
appropriate destination. 


3. Exit Setup mode. When the host delay is over, it will 
begin sending data to the terminal, which is now ready 
to receive it. 
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If the host is the destination device (you are copying from 
the terminal or some peripheral attached to the terminal to 
the host), you must likewise make sure that the host is ready 
to receive data before the COPY command is entered. 
Otherwise data will be lost. Procedures for this vary with the 
host. | 


The SPOOL Command 


One disadvantage to the COPY command is that the termi- 
nal cannot perform any other functions while the COPY 
operation is in progress. This can be inconvenient when the 
destination device is relatively slow. For example, you can 
copy a text file from the host computer to a printer attached 
to peripheral port 0 with the following command: 


COPY HO: TO PO: 


However, the terminal cannot perform any other functions 
until the printout is completed, which may take several 
minutes. Another example would be making a color hard 
copy of the screen display. Since current color copier tech- 
nology outputs data at a much slower rate than the terminal, 
time is lost when the terminal could be working on other 
tasks. 


The SPOOL command allows you to perform “background” 
transfers of information from a disk file. The idea is first to 
COPY the information to a disk file (if necessary) since this 
is a relatively fast operation. Then use the SPOOL com- 
mand to transfer the disk file to the output device, leaving 
the terminal free to do other tasks. For example, to copy a 
text file from the host to a printer, replace the single com- 
mand COPY HO: TO PO: by the two commands: 


COPY HO: TO F0:TEMPFILE.TX 
(Host-to-disk copy executes rapidly) 
SPOOL F0O:TEMPFILE.TX TO PO: 


This allows the terminal to proceed to other tasks as soon as 
the copy into the disk file from the host is complete. Data is 
“spooled” from the disk file to the printer without tying up 
the terminal. 


A SPOOL operation in progress can be halted, if necessary, 
by entering the STOP command. If the output is a file, the 
file is closed and any information already spooled is saved. 


SPOOL can also be used in place of a PLOT command, for 
the same reason given for COPY: to avoid tying up all termi- 
nal functions during output to aa relatively slow device. See 
Using A Plotter later in this section. 
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The SAVE Command With Disk Files 


The SAVE command allows you to save macro definitions or 
graphic segments as escape-sequence commands. Later 
you can read this file and execute the escape sequences in 
it with the LOAD command. | 


The following examples show how this command might be 
used. 


SAVE SEG 1 TO F0:SEGMENT1 
Saves graphic segment number 1 as a Series of escape- 
sequence commands in the disk file named SEGMENT 1. 


SAVE MAC 128 TO FO0:MACRO.65 

Saves macro definition number 128 (associated with Function 
Key 1) as aseries of escape-sequence commands in a disk file 
named MACRO.65. 


SAVE SEG -1 TO SEGMENTS 
Saves all graphic segment definitions as series of escape- 
sequence commands in a disk file named SEGMENTS. 


SAVE can be used to send information to other destinations 
than disk files. For example: 


SAVE SEG 3 TO PO: 


If a plotter is connected to Port 0, this will cause graphic 
segment 3 to be drawn on the plotter. (The port and plotter 
must be properly configured; see the Using A Plotter dis- 
cussion later in this section. Also see the SPOOL 
discussion.) 


The LOAD Command With Disk Files 


The LOAD command sends a file to the terminal's com- 
mand processor, which executes the file just as tf these 
commands had been sent from the host. Common uses for 
LOAD are to recreate graphic displays or to initialize the 
terminal for some applications program from the host (set 
baud rates, key definitions, etc.). For example, to execute 
the sample file INIT.CMD created in the COPY discussion 
earlier, just enter: 


LOAD INIT.CMD 


Since the file is on device FO:, the default device, no device 
name is needed. 


Another application involves storage and retrieval of graph- 
ics. Suppose a file named MODEL32.DAT is stored on the 
disk in drive 0. The following command will read the file, 
causing graphics commands to be executed by the terminal 
and the graphics information in the file to be displayed: 


LOAD F0:MODEL32.DAT 
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USING THE THREE-PORT 
PERIPHERAL INTERFACE 


Option 10, the Three-Port Peripheral Interface, provides 
RS232 communications support. The specific TEKTRONIX 
products supported by the 3PPI (Three-Port Peripheral 
Interface) are: 


© The 4662 Interactive Digital Plotter 

© The 4663 Interactive Digital Plotter 

© The 4643 Matrix Printer 

© The 4923 Option 01 Digital Cartridge Tape Drive 


The Option 10 rear panel connector (Figure 3-6) contains 
three RS232 connectors, labeled PORT 0, PORT 1, and 
PORT 2. 


The 3PPIi uses device drivers to support specific devices 
attached to one of the peripheral ports. A device driver is a 
program that interfaces the terminal with a specific device 
attached to the port. For example, some devices may 
require certain characters as part of their communications 
protocol; a device driver would make sure that these char- 
acters are present when required. 
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The 3PPI supports any RS232 device using its PPORT 
driver, which simply passes data through the port without 
any formatting. To set up Port O with the general PPORT 
driver, give the following command: 


PASSIGWN PO: PPORT 


You can format output to the 3PPI for specific Tektronix 
devices with the setup command PASSIGN. For example, 
you can connect a 4663 plotter to Port 0, and configure the 
port with the following command: 


PASSIGN PO: 4663/T 


This command assigns the 4663 device driver to Port 0; it 
also instructs the driver to translate terminal commands 
into 4663 commands in data sent to the plotter. See the 
PASSIGN command description in Section 6 for details. 


You can also use various setup commands to assign com- 
munications parameters to a peripheral port, much as you 
assign these parameters to the host port. Just as with the 

host, these parameters must be set to the values required 
by the device attached to the port, or communications will 
be garbled. The various port configuration commands are 
summarized under the following heading. 
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Figure 3-6. Three-Port Peripheral Interface Panel. 
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CONMAND SUMMARY 


Table 3-3 summarizes the commands used with the 3PPI. 
Each of these commands is discussed in detail in Section 6 
of this manual. However, refer to the 4//0 Series Host Pro- 
grammers Manual for the basic concepis of port communi- 
cations. 


Table 3-3 
THREE-PORT PERIPHERAL INTERFACE 
COMMAND SUMMARY 


Commana 


Description 


PASSIGN Assigns a device driver to a specified port. 


PBAUD Seis the baud rate for a specified port. 


PBITS Sets the number of stop bits and data bits fora 
specified port. 

PCOPY Establishes a two-way communication path 
between two devices. 

PEOF Seis the end-of-file string for the specified port. 

PEOL Sets the end-of-line string for the specified port. 
(Used only with the 4643 device driver.) 

PFLAG Sets the flagging method used by the specified 
port. 

PLOT Sends information to a plotter. 

PPARITY Sets the parity used by a specified port. 

STATUS 3PPI Displays a status report for all peripheral ports. 
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USING A PLOTTER 


CONNECTING THE PLOTTER 
YO THE TERMINAL 


When using a TEKTRONIX 4662 or 4663 Interactive Digital 
Plotter, connect the plotter’s “modem” connector to one of 
the terminal’s three RS-232 peripheral poris. 


NOTE 


Do not connect the plotter between the terminal’s 
host port and the host computer. Although the 
plotter is designed to run in this configuration, the 
terminal design assumes that the plotter is con- 
nected to one of the RS-232 peripheral poris. 


INITIALIZING THE PORT 


To use a TEKTRONIX 4662 or 46693 Interactive Digital Plot- 
ter with the terminal’s RS-232 peripheral port, you must set 
the plotter’s switches and the peripheral port seitings ina 
compatible way. For instance, if the plotter is set to operate 
at 1200 baud, then the peripheral port to which it is attached 
must also be set for 1200 baud. The terminal’s plotter driv- 
ers always use device address A. 


4662 Plotter. Table 3-4 shows one way the switches on the 
TEKTRONIX 4662 Digital Plotter can be set for communi- 
cating with the terminal through the terminal’s Option 10 
Three Port Peripheral Interface. 


Table 3-4 
4662 PLOTTER SETTINGS 


Switch 


Seiting 
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These switch positions set the 4662 as follows: 


Copy mode. 

CR implies CR-LF. 
GiNterminator = CR. 
Number of stop bits = 1. 
No Parity. 

Plotter device address = A. 
Baudrate = 1200. 


With the 4662’s switches set as in Table 3-4, the following 
SETUP mode commands will then initialize peripheral port 
zero for communicating with the plotter. The terminal 
remembers these settings even when turned off; thus the 
commands néed only be issued once, when attaching the 
plotter to the terminal. 


PBAUD PO: 1200 
Sets port zero to communicate with the 4662 at 1200 bits per 
second. 


PASSIGN PO: 4662 

Assigns the standard “4662” device protocol to peripheral port 
zero. (If the 4662 is equipped with multiple pens — Option 31 
— then the second parameter in this command should be 
“4662/MP” rather than “4662.) 


PPARITY PO: NONE 

PBITS PO: 1 8 

Sets peripheral port zero to send ASCII characters which have 
eight data bits, no parity bit, and one stop bit. 


PFLAG PO: NONE 

Disables DTR/CTS and character flagging at the peripheral 
port. (Instead, the plotter’s block mode is used to prevent data 
overrun.) 
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4663 Plotter. Table 3-5 shows one way to set the 4663 plot- 
ter’s parameter entry switches for use with the terminal. 


Suppose the plotter switches have been set as shown in 
Table 3-5. In that case, the following SETUP mode com- 
mands initialize peripheral port zero in the terminal for 
proper communication with the plotter: 


PBAUD PO: 9600 
Sets peripheral port zero to communicate with the plotter at 
9600 bits per second. 


PASSIGN PO: 4663 
Assigns the “4663” device protocol to peripheral port zero. 


PPARITY PO: NONE 

PBITS PO: 1 8 

Sets peripheral port zero to send ASCII characters which have 
eight data bits, no parity bit, and one stop bit. 


PFLAG PO: NONE 
Disables DTR/CTS and character flagging. (Instead of flag- 
ging, the plotter’s block mode protocol is used to prevent data 


overrun.) 
Table 3-5 
4663 PLOTTER SETTINGS 
Parameter Setting 
Initial aspect ratio 4X:3Y 


Y vertical, X horizontal 
1 (RS-232 interface) 


Initial axis orientation 
Interface select 


Initial command response format 3 (emulates a 4662) 
Serial device address A 

Receive baud rate 9600 

Transmit baud rate 9600 

Transmit baud rate limit Full speed 
Character format 8 data bits, 1 stop bit 


Receive parity/transmit parity 
Communications control mode 
Interface functions 


Ignore/logic zero 

Full duplex 

CR generates LF = YES, 
DEL IGNORE = NO 
Attention character ESC 

Output terminator CR 
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EXAMPLES OF USE 


The following show several command sequences that will 
transfer data to a plotter. 


DIRECTORY to a Plotier 


To send a directory to the plotter, the following conditions 
must be met: 


© The plotter must be set for “CR implies LF’, since each 
line in the directory report ends with °r, NOT with Cate. 


© Other plotter parameters required are: 


Attention character En 


Address character A 


Oo The port device driver should have an “NT” parameter 
assigned by a PASSIGN 4662/NT or PASSIGN 4663/NT 
command. 


O You (the operator) must position the ploiier pen (with the 
plotter’s joystick) to the upper left corner of the plotter’s 
viewport. 


Once these conditions are met, simply give a DIRECTORY 
command to the port to which the plotter is connected. For 
example, if the plotter is connecied to Port 0, the following 
command outputs a directory for the disk in drive 0: 


DIRECTORY FO: TO PO: 


Remember that device names must include the colon; Port 
O is device PO:, not simply PO. 


The PLOT Command 


You can draw all visible graphic segments tn the current view 
on an attached plotter by using the PLOT command. For 
example, if a plotter is attached to peripheral Port 0, just 
give the command: 


PLOT TO PO: 


This command also assumes that the port has been cor- 
rectly configured to receive output for the attached plotter 
(see the PASSIGN command). 


Note, however, that this command will tie up all other termi- 


nal operations until the PLOT is complete. A more efficient 
method is to use the SPOOL command discussed later. 
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SAVEing to a Plotter 


The SAVE command, although normally used for file crea- 
tion, will format data in a single graphic segment to allow it 
to be drawn correctly on to a plotter. Just give the SAVE 
command with a segment number. For example, if a plotter 
is attached to peripheral Port 1, you can plot segment 3 by 
giving the following command: 


SAVE SEG3TOP1: 


However, this will tie up terminal operations until all of seg- 
ment 3 has been plotted. A more efficient way is to use the 
SPOOL command discussed next. 


You can also save various classes of segments with SAVE; 
see the command description in Section 6. 
SPOOLiIng to a Pliotier 


As mentioned earlier, although you can PLOT or SAVE 
information directly to a plotter, it is generally more efficient 
first to save that information in a disk file, then spool from 
the disk file to the plotter, since spooling frees the terminal 
for other functions. For example, suppose a plotter is 
attached to Port 0. To plot all visible segments, replace: 


PLOT TO PO: 
with the two commands: 


PLOT TO FO:TEMPFILE 
SPOOL FO: TENMPFILE TO PO: 


To plot a particular segment, replace: 
SAVE SEG 3 TO PO: 
with the two commands: 


SAVE SEG 3 TO FO: TEMPFILE 
SPOOL FO:TEMPFILE TO PO: 


A spooling operation in progress can be halted with the 
STOP command. 
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Direct Host-to-Plotter Copy 


The commands discussed so far all depend on the termi- 
nal’s ability to translate 4110 Series escape-sequence com- 
mands to equivalent plotter commands. However, it is 
possible to copy from the host directly to the plotter, without 
using the terminal firmware at all. 


To do this you can use COPY or SPOOL with the port 
assigned an “NT” parameter (PASSIGN 4662/NT or 
4663/NT). This allows data to be sent directly to the plotter 
without translation. You can also use the PCOPY (Port- 
Copy) command. The advantage of PCOPY is that it sets up 
a two-way data path between the plotter and the host. This 
allows plotter status information, error codes, and GIN 
points to be sent from the plotter back to the host. See the 
4110 Series Host Programmers Manual for details. 


USING A PRINTER 


The 3PPI supports RS232 communication with the 
TEKTRONIX 4641, 4641-1, and 4643 Matrix Printers. The 
following tables show how to set up a peripheral port for 
sending data to one of these printers. 


Table 3-6 
PORT SETTINGS FOR PRINTERS 


Command 4643 Settings 4641(-1) Settings 


PBAUD 9600 9600 


1,8 | 
PEOL CR Crle 

PFLAG DTRICTS 
PASSIGN 4643 
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Setting the switches shown in the following tables 
requires opening the printer covers. DO NOT 
OPEN THE COVERS WHEN THE PRINTER IS 


TURNED ON. 


Table 3-7 


4643 SERIAL INTERFACE BOARD SETTINGS 


Switch 
S1-1 
S$1-2 
S$1-3 
S1-4 
S2-1 
S2-2 
S2-3 
S2-4 
S3-1 
S3-2 
S3-3 
S3-4 
S14-1 
S14-2 
S$14-3 
S14-4 
$14-5 
$14-6 
$14-7 
$14-8 
$15-1 
$15-2 
515-3 
S15-4 
$15-5 
S15-6 
S15-7 
$15-8 


Setting 


ON 
ON 
OFF 
AID 
ON 
ON 
ON 
A/D 
OFF 
OFF 
OFF 
OFF 
OFF 
OFF 
OFF 
ON 
OFF 
OFF 
OFF 
OFF 
AID 
OFF 
OFF 
OFF 
ON 
OFF 
AID 
OFF 
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Table 3-8 
4641(-1) INTERFACE CARD SETTINGS 


Switch Setting 
S1 OFF 
S2 ON 
S3 OFF 
S4 ON 
S5 OFF 
S6 ON 
S7 ON 
S8 OFF 
EXAMPLES OF USE 
DIRECTORY to a Printer 


You can output a disk or file directory to an attached printer 
with the DIRECTORY command. For this to work, the pori’s 
end-of-line string must be set to °r'e by the PEOL com- 
mand. This instructs the terminal to send ©r'r at the end of 
each line in the directory message, rather than just ©r. 


The other port communication parameters must match 
those of the printer. See the 3PPI Command Summary 
discussion. 


Once these conditions are met, just give the DIRECTORY 
command with the proper peripheral port as the device 
name. For example, suppose a printer is attached to Port 0 
and the port has been properly configured. To print a direc- 
tory of the disk in drive 0 on the printer, just give the com- 
mand: 


DIRECTORY FO: TO PO: 
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COPYing to a Printer 


Data can be transferred to a printer with the COPY com- 
mand. For example, to output a text file called RESULTS on 
the disk in drive 0 to the printer attached to Port 0, give the 
following command: 


COPY RESULTS TO PO: 


Note that since device FO: is the default device, no “FO:”’ 
designation is needed on the source. Also note that a COPY 
command ties up the terminal until the COPY is completed; 
if the file to be copied is of any length, it is probably better to 
use the SPOOL command, discussed next. 


SPOOLIiIng to a Printer 


As mentioned earlier, spooling allows “background data 
transfers” between devices, allowing the terminal to per- 
form other activities while the transfer is in progress. For 
example, instead of sending a disk directory to the printer 
with a DIRECTORY command, you could send it first toa 
disk file and then spool it from the disk file to the printer 
while using the terminal for other tasks. To send a directory 
of a disk in drive 0 to a printer attached to Port 0, give the 
following commands: 


DIRECTORY FO: TO F0:DIRECT 
SPOOL FO:DIRECT TO PO: 


Since FO: is the default device, the commands could be 
given as: 


DIRECTORY TO DIRECT 
SPOOL DIRECT TO PO: 


A spooling operation in progress can be halted with the 
STOP command. 
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USING THE 4923 TAPE DRIVE 


You can attach a TEKTRONIX 4923 Digital Cartridge Tape 
Drive with Option 01 installed to one of the terminal’s 
peripheral ports. Plug the RS-232 cable into the MODEM 
connector on the tape drive and into one of the 3PPI con- 
nectors on the rear of the terminal. Then configure that port 
(say, Port 0) with the PASSIGN command: 


PASSIGN P0: PPORT 


Use the PBAUD command to set the port baud rate to 
match the tape drive’s baud rate (Shown by the tape drive’s 
baud rate control knob on the back of the drive). 


Use the PFLAG command to set terminal flagging to 
“DC1/DC3’. Set all other port communication parameters 
to match the conventions used in files to be stored on the 
tape. 


When the terminal is receiving data from the tape drive, you 
can indicate an end-of-file by pressing the terminal’s CAN- 
CEL key after the data has been transferred. This erases 


the last received data that would otherwise be left inside the. 


3PPI. 


USING OTHER RS232 DEVICES 


You can use the 3PPI with any RS232 device as long as the 
port communication parameters are compatible with or 
match those of the attached device. In particular, the 
PPORT (general purpose peripheral port) device driver 
should be assigned to the port with the command: 


PASSIGN Px: PPORT 
Here x is the appropriate port number (0, 1, or 2). 


The other port settings depend on the requirements of the 
particular device. 
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USING A 4691 COLOR COPIER 


With Option 09, the 4691 Color Graphics Copier Interface, 
installed the terminal can make color copies of the screen 
display. The Option 09 interface includes a connector 
labeled TO 4690 SERIES COPIER on the back of the termi- 
nal, and special commands for making color copies. 


To connect the color copier, attach the copier’s cable to the 
TO 4690 SERIES COPIER connector on the terminal’s back | 
panel. Secure the cable to this connector with the wire clips 
attached to the connector (Figure 3-7). 


Option 09 includes the following commands: 


HCDATARES { 1 } 
2 

Sets the precision of data sent to the copier. A resolution of 2 

makes higher resolution hard copies, but takes longer to make 

each copy. 


HCINTERFACE { color 

mono 
Allows you to select either a color copier or a monochrome 
hard copy unit to make copies in response to a copy request. 


HCORIENT { horizontal 

vbottom 

vcenter 

vtop 
Sets the orientation of the copied image on the copy medium. 
HCCOPIES n 


Sets the number of hard copies produced by each copy 
request to 7, where 7 is an integer. 


HCRESERVE fyes 
i 

Determines whether the terminal reserves the color copier’s 

attention or whether the color copier’s multiplexer (which polls 

other connected devices) is free to make copies from other 

units. 


Each of these commands ts explained in detail in the com- 
mand descriptions in Section 6. 


You can make hard copies of the screen on a monochrome 
hard copy unit with the standard terminal (see Using A 
Monochrome Hard Copy Unit discussion following). How- 
ever, if you have Option 09 installed, you can still make 
copies on a monochrome hard copy unit by selecting the 
monochrome interface with the command: 


HCINTERFACE mono 


Once the interface is selected, it remains set until you 
change it or turn off the terminal. 
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Figure 3-7. Color Copier Connector. 
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Hard copies are produced when: 


@ The terminal receives a <hardcopy> escape sequence 
command. 


@ The terminal receives a <4010-hardcopy> escape 
sequence command. 


@ You press the HARD COPY key, either shifted or 
unshifted. The unshifted HARD COPY key makes a copy 
of the screen just as it appears. The shifted HARD COPY 
key makes a “reverse video” image, with black copying 
to white and white to black (for color copies, other colors 
copy as they appear on the screen). 


@ You give the following setup command: 
COPY SC: TO HC: 


This command copies the pixel viewport to the attached 
hard copy unit. Since the COPY operation ties up all 
terminal functions until the hard copy is complete, you 
may want to copy the screen to disk first and then spool it 
to the hard copy unit: 


COPY SC: TO F0:COLORCPY 
SPOOL F0:COLORCPY TO HC: 


The COPY command creates a file on the disk; the termi- 
nal is then free for other operations while the SPOOL 
command makes the hard copy. 


NOTE 


If you copy the screen to a file on disk and you plan 
to make a hard copy of the file later, be sure that 
the same size media is in the hard copy unit when 
the hard copy is made. 


When you COPY from SC: to a disk, the media size cur- 
rently in the hard copy unit is encoded with the disk file. If 
you change the size of the media and then spool the 
stored file to the hard copy unit, the terminal issues an 
error message; the error tells you that the data is format- 
ted for another size media. To avoid this error, make sure 
that the hard copy unit has the same size paper in it as it 
did when the screen contents were stored to disk. 


See Section 6 for details on the COPY and SPOOL 
commands. 
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Using a Multiplexed Color Copier 


A 4691 Color Graphics Copier equipped with Option 02 (the 
four-channel multiplexer) can poll up to four different 
devices and make copies from any of those devices. When 
a 4115B/M4115B terminal with Option 09 is connected as 
one of those devices, you can reserve the copier’s attention 
and restrict device polling with this setup command: 


HCRESERVE yes 


You can then make acolor hard copy, either by pressing the 
HARD COPY key, issuing the “Hardcopy” escape com- 
mand, or by issuing a COPY or SPOOL command (with HC: 
as the destination). After the copier completes the copy, the 
copier’s multiplexer resumes its polling of the connected 
devices. 


Reserving the copier can be particularly useful in these two 
applications: 


@ When the copier is reserved, you can change the type of 
media and make a copy without another device interfer- 
ing. This is useful for changing from paper to film. 


@ When the copier is reserved, if you want to make several 
copies sequentially, without interruption from another 
multiplexed device, you can set HCCOPIES to the num- 
ber of copies required and reserve the terminal with 
HCRESERVE yes. When all the copies are completed, 
the terminal restores device polling. 


See the description of HCRESERVE in Section 6 for more 
information. 


USING A MONOCHROME HARD 
COPY UNIT 


A monochrome hard copy unit provides monochrome or 
grayscale hard copies of the display. The cable on the 
hard copy unit is attached to the TO HARD COPY con- 
nector, which is on the standard terminal back panel 
(Figure 3-8). 
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Figure 3-8. TO HARD COPY Connecior. 
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A monochrome hard copy unit should be on for about 10 
minutes before you make copies with it. If the unit is not 
warmed up, copies will be faint or entirely white. 


To make a copy, press the HARD COPY key on the termi- 
nal’s keyboard or the COPY key on the hard copy unit. 
Color displays produce gray-scale monochrome copies, 
with each color being mapped to a unique gray (see the 
CMAP command description in Section 6). Pressing Shift- 
HARD COPY makes a “reverse video” copy, with white 
copying to black and black to white. 


If the terminal has Option 09, 4691 Color Graphics Copier 
Interface, installed, you can select either the monochrome 
hard copy unit or the color graphics copier with the HCIN- 
TERFACE command. See the Using the 4691 Color Graph- 
ics Copier discussion earlier in this section. 


USING A TABLET OPTION 


The two graphics tablet options (Options 13 and 14) are the 
same except for the size of the tablets. Option 13 contains 
an 11x11 inch tablet; Option 14 contains a 30x40 inch tab- 
let. Since the operating instructions are the same, in this 
manual they are both referred to simply as the graphics 
tablet, or just the tablet. 
Both tablets include: 
@ The tablet (with cables connected to it) 
@ The input devices (one or more of the following): 

e Astylus (standard) 

e A one-button cursor (optional) 

e A four-button cursor (optional) 
® A bar magnet for restoring the tablet’s bias 


® A precision grid (optional) 
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This manual assumes that the hardware for the tablet is 
installed and that it is ready for use. If that is not the case, a 
qualified technician should follow the installation instruc- 
tions included in the 4110 Series F13/14 Graphics Tablet 
Instruction Manual. 


Table 3-9 lists the terminal’s setup commands that deal 
specifically with the operation of the tablet. See Section 6 
for more details. 


Table 3-9 
TABLET SETUP COMMANDS 
Command Explanation 
TBFILTER Specifies the time and distance filtering 


the tablet is to use for strokes in 
Graphics Input mode. 


TBHEADERCHARS | Specifies the header characters used by 
the tablet when it sends data to the host 


program. 

TBSTATUS Specifies how the tablet emulates the 
TEKTRONIX 4953 or 4954 Graphics 
Tablet. 

TBSIZE Specifies active area size of the tablet. 

ATTACHING THE TABLET 


Figure 3-9 shows the tablet connectors for the 4115B and 
M4115B terminals. On the rear panel of the 4115B (Figure 
3-9A), there are three connectors for the tablet: one for the 
input device (stylus, one-button cursor, or four-button cur- 
sor), a second for the upper left tablet cable, and a third for 
the lower right tablet cable. The M4115B electronics mod- 
ule (Figure 3-9B), on the other hand, has a single tablet 
connector on its rear panel; this is because the electronics 
module connects to the tablet via a special interface box. 
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Figure 3-9. Tablet Interface Connector. 
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MODULE 


Figure 3-10A shows how the tablet interface box connects 
to the electronics module; Figure 3-10B illustrates how the 
tablet cables connect to the interface box. 


Whether you have a 4115B or an M4115B (with an interface 
box), be sure that you plug in the tablet cables properly. If 
the cables are not connected correctly, then the tablet will 
not function as it should. 


TABLET 
INTERFACE 
CONNECTOR 


THE STYLUS 


There are two different kinds of fillers for the stylus. One is a 
ballpoint filler; the other filler is a blank, which doesn’t draw 

lines. You can use either of these fillers, depending on your 

needs. 


To change a filler, unscrew the bottom part of the stylus just A. Connecting the Tablet Interface Box to the M4115B. 
as you would a ballpoint pen. Gently pull the filler straight 


down. Be careful not to break either of the two probes 
(Figure 3-11). Insert the other filler and screw the stylus 


LOWER RIGHT 
back fogemer POENER 
POSITIONING THE PRECISION GRID UPPER LEFT 


CORNER STYLUS 


The precision grid is an optional accessory to the graphics 
tablet. If you have one, the grid can be used to help you 
enter data more precisely. 


The procedure for positioning the grid on the tablet is 
included in the 47/0 Series F13/14 Graphics Tablet Instruc- 
tion Manual. 


CLEANING THE TABLET SURFACE 


Clean the tablet as often as necessary, using a damp cloth 
and mild detergent such as window or glass cleaner. Do not 
immerse the tablet in water or get it too wet. Never use a 
cleaner that contains hydrocarbons, since they will dissolve 
the tablet surface. 


B. Interface Box Connectors. 


Figure 3-10. Attaching the Tablet to the M4115B. 


Keep the tablet biasing magnet away from the 
terminal. Internal magnetic fields may change, 
requiring readjustment. Also keep magnetic tapes, 
flexible disks, and other magnetically sensitive 
items away from the tablet surface. 


4665-87 
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RESTORING THE TABLET BIAS 3. Pull the magnet across the tablet from the upper-left 
corner towards the lower-right corner in a single, 

About once a week, you should use the following procedure smooth motion (Figure 3-12). Wipe the entire surface in 

to restore the tablet’s magnetic bias. Use this procedure about two or three seconds. 

more often if the tablet begins to relay incorrect data or if the 

graphics cursor moves erratically. 4. Reconnect the tablet, plug the terminal back in, and 
turn it on. 


1. Turnthe terminal off and unplug it. 
Store the magnet away from the tablet and other magneti- 


2. Disconnect the tablet from the interface. cally sensitive items (such as flexible disks and magnetic 
tapes). 


PaaS I ow > 


Figure 3-11. Taking the Stylus Apart. 


Figure 3-12. Restoring the Tablet Bias. 
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Section 4 


GRAPHICS INPUT MODE 


OVERVIEW OF GIN MODE 


Graphics Input (GIN) mode allows you to send graphics 
information to a host program. This section includes an 
explanation of how to position the graphics cursor with each 
input device and how to use each of the GIN functions. 


Usually a host resident program will put the terminal into 
GIN mode and prompt you for certain information. You can 
use escape sequence commands in Setup mode to put the 
terminal in GIN mode. For detailed information on the GIN 
functions see the 4//0 Series Host Programmers Manual. 


The host resident program should also prompt you concern- 
ing what kind of data you should enter. For example, it might 
tell you to locate a certain number of points on the screen 
(the /ocate function), to pick a certain menu item or part of 
the picture (the pick function), or to enter points continu- 
ously every so often or so far apart (the stroke function). 


The devices that you can use to locate and send graphics 
information to a program are: 

O The terminal’s thumbwheels 

O A graphics tablet 

© A 4662 cr 4663 Plotter 

An explanation of how to position the graphics cursor with 


each input device and how to use each of the functions is 
included in this section. 


Appendix F shows examples of GIN operations. 


THE PICK FUNCTION 


When graphic information is stored in segments, a pick 
function allows you to select items or actions by positioning 
the GIN cursor. 
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A program might be written so you are asked to choose 
between several actions. This list of actions is called the 
menu. The program would instruct you to pick the desired 
action. To do so, position the graphics cursor on or near the 
description of the appropriate action. The way you signal 
the program that the cursor is at the position you want to 
pick depends on the input device you are using. These 
methods are described later in this section. 


You might also be asked to pick a part of the picture to be 
moved, enlarged, reoriented, or changed in some way. 
Again, you would position the graphics cursor on or near the 
object and signal the program that the cursor is at the loca- 
tion you want to pick. 


TRE LOCATE FUNCTION 


You can /ocate a particular point on the display by moving 
the graphics cursor to the appropriate point on the screen. 
When it is properly located, signal the program that you 
have located the cursor. The input device sends the coordi- 
nates of that point to the program. 


INTING 


As you locate points on the screen, you can draw lines 
between these points by using the inking function. Inking is 
activated by an escape sequence command (see Appendix 
C) or by the GININKING setup command. 


RUBBERBANDING 


When you move the cursor, you can have a line “follow” the 
graphics cursor. One end of the line is anchored at the last 
point and the other end of the line is attached to the graph- 
ics cursor. This is called rubberbanding. Rubberbanding is 
activated by an escape sequence command (see Appendix 
C) or by the GINGRIDDING setup command. Both inking 
and rubberbanding can be active at the same time. 
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GRIDDING _ When you have positioned the graphics cursor where you 
want it, send the location of that point to the program by 

A program can also specify that an invisible grid be in effect pressing any alphanumeric key. When you press the key, 

on the screen. When a grid is active, you can only locate the the crosshair cursor blinks momentarily as the point is 

cursor on points where the vertical and horizontal lines of transmitted to the program. Do not press the Rtn key, as that 

the grid intersect. This allows you to precisely position the causes invalid data to be transmitted. 


cursor when it is necessary to draw lines that intersect ata 
90° angle. When you move the graphics cursor, it may 
jump from one point to the next. If this happens, you will 
know that gridding is probably in effect and the cursor is 
moving between points on the grid. 


The setup command, GINGRIDDING, allows you to easily 
establish a grid for the input device. See Section 6. 


THE STROKE FUNCTION 


With a graphics tablet (Option 13 or 14), you can senda 
steady stream of points to the host as you move the stylus 
across the tablet surface. Since each movement of the 
stylus causes a large number of points to be sent to the | ; | Be tres 
host, the TBFILTER command is usually used to filter the oS OP Fgee ee 
number of points sent to the host; TBFILTER allows you to — | | | are eee 
- specify a minimum distance or time between points. (See Figure 4-1. The Crosshair Cursor. 

the TBFILTER command description in Section 6.) 


USING THE TERMINAL’S 
THUMBWHEELS 


When the terminal is in GIN mode, a graphics cursor 
appears on the screen. The default is the crosshair cursor 
(Figure 4-1). However, the program can select another user- 
defined segment to be the graphics cursor. 


Position the graphics cursor with the thumbwheels 

(Figure 4-2). As the arrows on the keyboard indicate, the top 
thumbwheel moves the graphics cursor up and down and 
the bottom thumbwheel moves it back and forth across the 
screen. | 


The cursor moves more slowly if you hold down the Shift 
key as you rotate a thumbwheel. This allows you to position 
the cursor more precisely. This is an example of vernier 
action (see Section 2). 


Figure 4-2. The Thumbwheels. 
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USING THE TASLET 


When you use a graphics tablet for a GIN device, the graph- 
ics cursor will be visible on the screen. The crosshair cursor 
(Figure 4-1) is the default graphics cursor, but the program 
can select any segment as the cursor. The applications 
program should inform you as to what the graphics cursor 
is, if itis not evident. 


\When the tablet is active, you can use one of three input 
devices: the stylus, a single-button cursor, or a four-button 
cursor (Figure 4-3). 


You can locate points inan11 x 11” square on the smaller 
tablet (Option 13) and a 30 x 40” area on the larger tablet 
(Option 14). This is called the active writing urea. In both 
cases, the center of the active writing area is the center of 
the tablet. 


GRAPHICS INPUT MODE 


THE STYLUS, THE ONE-BUTTON CURSOR, 
AND THE FOUR-BUTTON CURSOR 


The Stylus 


Hold the stylus as you would a ballpoint pen, with the tip 
resting on the tablet. The crosshair cursor on the terminal 
screen tracks the stylus as you move it. The tablet can keep 
track of the stylus as long as it is within 5/32 of an inch of the 
tablet surface. Press down on the stylus to send the point’s 
iccation to the computer. The stylus’s tip moves slightly and 
the graphics cursor blinks momentarily as the point is trans- 
mitted to the applications program. 


The One-Button Cursor 


To use the one-button cursor, lay the cursor flat on the tablet 
surface with the button facing up. AS you move the cursor 
along the surface of the tablet, the graphics cursor follows tt 
across the screen. When you use the pick and locate func- 
tions, locate the appropriate point on the tablet or terminal 
display and press down on the button. 


STYLUS 


MAGNET 


1-BUTTON 
CURSOR 


4-BUTTON 
CURSOR 


4665-33 


Figure 4-3. The Option 13 Graphic Tablet. 
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GRAPHICS INPUT MODE 


For the stroke function, hold down the stylus or cursor but- 
ton and move the stylus or cursor across the tablet surface 
as if you were drawing on it. The number of points transmit- 
ted to the program depends on the setting of the TBFILTER 
command (see Section 6). 


The Four-Button Cursor 


Lay the cursor flat on the tablet surface with the buttons 
facing up. As you move it along the surface of the tablet, the 
cursor tracks it. 


The functions of the four buttons can be defined by the 
applications program. For example, one button might cause 
inking to be used, another button might erase the line 
between the next two points, the third could implement the 
stroke function, and so on. The applications program should 
inform you how to use the buttons. 


If the buttons are not programmed, you can press any of the 
four buttons to transmit the current location of the graphics 
cursor to the applications program. 
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USING THE 4662 OR 
4663 PLOTTER IN GIN MODE 


Use the plotter’s joystick to position the pen at the appropri- 
ate location. If you are using a 4662 to indicate to the pro- 
gram that you have located the point you want, press the 
plotter’s CALL button until the plotter beeps one time, then 
release it. If you are using a 4663, press the plotter’s DRAW 
POINT button when you locate the point you want. 


For additional operating instructions, see the 4662 or 4663 
Operators Manual. 


NOTE 


When using a plotter for graphic input, the cursor 
image on the terminal’s screen does not continu- 
ously follow the plotter’s pen. The graphic cursor 
image on the terminal's screen is updated once for 
every GIN event. 
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Section 5 


FlOST COMMUNICATIONS OVERVIEW 


This section provides an overview of the concepts involved 
in communications between the terminal and a host com- 
puter. Most communications parameters are set by the host 


Table 5-1 lists all setup commands that set host communica- 
tions parameters. The commands under the heading Stand- 
ard Commands are standard for the terminal. The com- 


— either by a system-level program or an applications pro- 
gram. However, some parameters must be set correctly 
from the keyboard or a disk file before any communications 
at all can occur. For example, if the host and the terminal 
have conflicting baud rates (data transmission rates), com- 
munications will be garbled. In a similar fashion, if the host 
checks for even parity and the terminal transmits odd parity, 
communications problems will occur. 


Therefore, it is important for the operator to understand the 


mands under the heading Optional Commands are part of 
the Extended Communications Interface (Option 01). 


Many of the concepts discussed here also apply to com- 
munications with other devices. In fact, several setup com- 
mands that begin with the letter P set parameters for com- 
munications through the 3PPI (Option 10) — PBAUD, 
PBITS, etc. For details on all communications concepts and 
commands, refer to the 4//0 Series Host Programmers 
Manual, your host system manuals, or your system 


basic communications concepts to avoid these problems programmer. 
and to correct them promptly if they occur. The rest of this 
section discusses the basic concepts that you need to moni- 
tor and correct such problems. 
Table 5-1 


COMMUNICATIONS COMMANDS 


Standard 

Commands Explanation 

BAUDRATE Specifies transmit and receive baud rates. 

BREAKTIME Specifies length of break transmission. 

BYPASSCANCEL Specifies bypass cancel character. 

EOFSTRING Specifies end-of-file string. 

EOLSTRING Specifies end-of-line string. 

EOMCHARS Specifies end-of-message characters. 

FLAGGING Specifies whether flagging is used and what 
kind. 

PARITY Specifies how parity is checked. 

PROMPTMODE Specifies whether or not terminal is in 


PROMPTSTRING 


Prompt mode. 


Specifies prompt string. 


QUEUESIZE Specifies size of terminal’s input queue. 

STOPBITS Specifies number of stop bits used. 

XMTDELAY Specifies time terminal waits after 
transmitting an end-of-message character 
before resuming transmission. 

XMTLIMIT Sets upper-limit of terminal’s transmission 
rate. 
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Optional 
Commands 


BCONTINUECHARS 


Explanation 


Specifies block-continue characters. 


BENDCHARS Specifies block-end characters. 
BHEADERS Specifies block-header sequences. 
BLENGTH Specifies block length. 


BLINELENGTH 


Specifies maximum line length for Block 
mode. 


BLOCKMODE Specifies Block mode. 

BMASTERCHARS Specifies block-master characters. 

BNONXMTCHARS Specifies block non-transmittable 
characters. 

BPACKING Specifies manner in which blocks are 
packed for transmission and receiving. 

BTIMEOUT Specifies how long terminal waits before 
retransmitting previous block. 

DUPLEX Specifies Duplex mode. 
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STANDARD COMMUNICATIONS 


The terminal’s standard communications feature all facili- 
ties necessary to support I/O with most host computers. 
These include: 


@ Full duplex 
© RS-232-C compatibility 
@ Prompt mode 


® Flagging 


Full duplex implies that the terminal can send and receive 
data at the same time. Whether this actually occurs 
depends on whether the host is capable of sending and 
receiving data simultaneously. 


Prompt mode, flagging, and half duplex are explained later 
in this section. 


COMMUNICATIONS CONCEPTS 


The following text explains concepts and terminology that 
apply to standard communications commands. They also 
apply to communications in Block mode and Half Duplex 
mode. 


Baud Rate 


The baud rate is the rate at which data is transmitted 
between the host and the terminal. As used in this manual, 
the term baud rate means “bits per second.” Transmission 
at a rate of 9600 baud means 9600 bits per second, or 
approximately 960 characters per second. 


The factory default baud rate is 2400. You can use the setup 
command BAUDRATE to modify it. The transmit and 
receive baud rates can be set independently. 


The terminal must be set to communicate at the same baud 
rates as the host. If not, data will be misinterpreted or not 
communicated at all. You can use the STATUS command to 
determine the terminal’s current transmit and receive baud 
rates. 
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Parity 


Parity checking is one way to verify the accuracy of data 
transmission on a character-by-character basis. Each char- 
acter is coded into eight bits (binary digits). The first seven 
bits define the character itself. The eighth bit is used as a 
parity bit; the word parity refers to whether the sum of digits 
in the character is even or odd. 


There are several schemes for parity checking. For exam- 
ple, the parity bit may be set so that the total number of ones 
in the character is even. This is called even parity. As a 
character is received by the host, the sum of its bits is calcu- 
lated; if this sum is odd, the host knows that an error in 
transmitting the character has occurred. Odd parity works 
the same way, except that the parity bit is set so that the 
sum of all bits in the character is odd. 


Other common parity schemes are high (parity bit is always 
set to one), none (parity bit is always set to zero), and data 
(parity bit is used as part of the data and no parity checking 
is performed). 


The method of setting the parity bit in characters transmit- 
ted to the host is determined by the PARITY command. This 
parity must be set to match what the host expects; other- 
wise the host will detect errors in transmission when there 
are none, and communications will be disrupted. 


Flagging 


It may be necessary for the terminal and the host to inform 
each other when each is ready to receive data and when 
transmission should be temporarily suspended. 


The terminal has an input queue into which data is collected 
until it can be processed. When the input queue is full, the 
terminal can send a character (called a flag) to stop data 
transmission from the host. Any additional data that the host 
tries to send to the terminal is lost. When there is more room 
in the queue, another flag is sent to tell the host to resume 
transmission. 


This is not used on all hosts. Some hosts require different 
kinds of flagging. The setup command FLAGGING allows 
the operator or programmer to define the flagging 
parameters. 
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Queue Size 


When the terminal receives data from the host computer, it 
stores this in an input queue — an internal data buffer — 
until this data can be processed. The QUEUESIZE com- 
mand specifies the size of the queue. Its size depends on 
the host computer, the rate of transmission, the kind of 
communications link used, and other installation-dependent 
factors. The factory default queue size is 300 bytes. 


KM Limi 


Sometimes the rate at which a host computer can effec- 
tively receive data is less than the maximum baud rate 
specified for the communications port. 


For example, a time-share host servicing many users may 
not be able to receive data at 9600 baud, even though you 
are logged onto a 9600 baud port. In such a case, you could 
leave the terminal’s transmit baud rate setting at 9600, but 
set the transmit-limit parameter (established by the 
XMTLIMIT command) to a level with which the host can 
cope — perhaps 8000. The terminal then sees to it that data 
is not transmitted at a rate faster than 8000 baud. 


The baud rate is not actually changed, but the characters 
transmitted are spaced so that the number transmitted per 
second Is the same as if the baud rate were the transmit 
limit rate. 


The factory default transmit limit is 19200 baud. If your host 
can receive data at speeds up to 19200 baud, you do not 
have to be concerned with the transmit limit. Check with 
your programmer to find out. 


sreak Time 


There will be occasions when you need to interrupt the 
transmission of data from the host or halt a host program. 
One way to do so is to press the Break key. 


The Break key sends an interrupt transmission to the host. 
The length of the interrupt is set by acommand called 
BREAKTIME. The factory default BREAKTIME parameter is 
set to 200 ms. However, it may need to be longer or shorter: 
on some hosts, you may not want to use the Break key at all. 
In that case, BREAKTIME can be set toO ms. 
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EOL String 


The EOLSTRING command (see Section 6) is used to 
change the end-of-line string. The end-of-line string indi- 
cates the end of the transmission of a line of data. It is sent 
by the terminal at the end of (or during) transmissions gen- 
erated by the terminal. 


The factory default end-of-line string is the carriage return 
(CR). This works for all hosts that interpret the carriage return 
as the end of a particular line of data. 


Since you explicitly inform the host of the end of a line by 
typing a “rn when entering data from the keyboard, no 
special action must be taken by the terminal. 


Sometimes the host requests information from the terminal 
that is sent in a different format and requires no operator 
interaction. The program may request a report of error 
messages, for example, or some graphics input data. In 
such cases, the terminal sends an end-of-line character to 
the host to indicate the end of a transmission. 


XMT Delay 


In some cases a part of the data transmission system — 
perhaps a modem — requires a little time to change from a 
transmit state to a receive state or vice versa. This delay is 
called the turnaround time, since it is the time needed to 
reverse the direction of data transmission. To accommodate 
such turnaround delays, the terminal can be set to waita 
certain length of time after it receives a host transmission 
before transmitting data back. 


This transmit delay is set with the XMTDELAY command. 
The transmit delay can be set from 0 to 65535 ms (about 
one minute). Turnaround times, if required, are typically 
about 50 to 100 ms. Consult with your host system program- 
mer to find out if a transmit delay is required, and if so, how 
long the delay must be. 


EOF Siring 


When files are transferred between the host and terminal, it 
is necessary to know when the file transfer is complete. This 
is indicated by an end-of-file string of from one to ten ASCII 

characters. 


HOST COMMUNICATIONS OVERVIEW 


When a data file is transferred from the host to the terminal 
using a COPY or SPOOL commang, the host must send the 
end-of-file string when it reaches the end of the file. The 
terminal sends the same string to the host when it reaches 
the end of a file it is transferring to the host. 


The terminal’s end-of-file string is defined by the EOF- 
STRING command. It should be set to whatever the host 
computer sends when it reaches the end of a file. It is best 
to set this to the null string except when you are actually 
transmitting files, since the string is ignored by the terminal 
whenever it is detected in a host transmission. 


Stop Bits 


Each character sent between the host and terminal is coded 
into eight binary digits (bits) of data. Each of these eight-bit 
codes is called a byte. 


After sending a byte of data, the host or terminal sends 
either one or two extra bits to indicate the end of a byte. 
These extra bits are called stop bits 


The terminal includes a STOPBITS command, which allows 
you to specify whether the terminal sends one or two stop 
bits at the end of each byte. The factory default is 1. 


EOM Characters 


The end-of-message characters are used during communi- 
cations turnaround between the terminal and the host. 


When the terminal is transmitting to the host and it encoun- 
ters an end-of-message character, it transmits that charac- 
ter and then pauses for a period of time before resuming 
transmission. 


If the terminal is in Prompt mode, when it sees the end-of- 
message character it knows to wait for a prompt string from 
the host before resuming transmission. When the terminal 
is in Block mode, it first transmits the block, then waits for 
the time specified by XMTDELAY and then waits for the next 
prompt. The period of time the terminal waits is specified by 
the XMTDELAY command | 


5-4 REV, JAN 1984 


The end-of-message characters are set by the EOMCHARS 
command. The factory default characters are CARRIAGE 
RETURN (Cr) and LINE FEED (‘r). Setting both end-of- 
message characters to NUL (‘L) disables this feature since 
N_ is ignored by the terminal. 


Bypass Cancel Character 


There are many characters that are transmitted between 
the host and the terminal that you do not want to see. For 
example, graphics input characters and other report char- 
acters are not important to an operator, yet they must be 
processed by the terminal. | 


Instead of being displayed, these characters are automati- 
cally bypassed. The bypass cancel character is used by the 
4110 Series terminals to assure that the correct characters 
are bypassed and that the display of characters is resumed. 


This character is specified by the BYPASSCANCEL com- 
mand. The factory default is the line feed character. 


PROMPT MODE 


Prompt mode is one way of managing communications 
between the terminal and the host computer. In Prompt 
mode, data to be sent to the host is stored in an output 
queue. When a predefined string of characters — called a 
prompt string — is received from the host (and the transmit 
delay satisfied), the terminal sends data from the output 
queue until it sees the end-of-message character. After it 
sends the end-of-message character, the terminal halts 
transmission until it receives another prompt string from the 
host. This allows the host to decide when it is ready for more 
data from the terminal. 


The PROMPTMODE command can be used to enter or exit 

Prompt mode. The PROMPTSTRING command specifies a 

string of one to ten ASCII characters that the terminal recog- 
nizes as the prompt string. This string must match the string 
sent by the host. 


All of the standard communications commands (see Table 
5-1) remain valid in Prompt mode. 
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BLOCK NODE 


In Block mode (available with Option 01) data is packed into 
blocks and each block transmitted as a burst of data. After 
each block is transmitted, there must be a response from 
the device that received it before another block is sent. This 
process verifies the accuracy of the transmission of each 
block. If there were any errors in the transmission, the same 
block is retransmitted until it arrives in a correct form. 


Because of this format, Block mode allows easier transmis- 
sion of full ASCil or binary code. It also provides error detec- 
tion and automatic retransmission of bad data blocks. 


Block mode can be used at the same time as Prompt mode 
and in Full Duplex or Half Duplex mode. 


Specific details concerning how Block mode works are 
rather involved. The 4//0 Series Host Programmers Manual 
contains more information on Block mode. 


The BLOCKMODE command arms (prepares) the terminal 
for entering Block mode. The terminal actually enters Block 
mode when it receives the first block header sequence. 


The following command definitions are an introduction to 
the concepts of Block mode communications. They are 
included because there are setup commands that specify 
these parameters. The syntax of each Block mode com- 
munications command is detailed in Section 6. 


BLENGTH 


The BLENGTH command specifies the maximum length of 
each block for both transmitting and receiving. The factory 
default block length is 256 bytes (characters). 


The best size for a block length depends on several factors. 
After each block is transmitted by either the terminal or the 
host, a response is required before the next block is sent. 
The shorter the block, the more time is spent responding to 
blocks sent and received. For a long block, more time is 
spent retransmitting a biock if retransmitting is necessary. 
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BHEADERS 


The start of each line of data in Block mode is indicated by a 
header sequence. The header sequence is a string of from 
one to ten ASCII characters. The first character in the 
sequence cannot be used elsewhere in the sequence; and 
the sequence cannot include any character that is part of 
the prompt string. 


The BHEADERS command specifies the header sequence. 
The factory defaults are HEADTX and HEADRX. 


BCONTINUECHARS 


A block of data may be one or more lines long. If a block 
extends to more than one line, each line ends with a block- 
continue character, indicating that more lines follow. There 
can be different block-continue characters for transmitting 
and receiving. 


The BCONTINUECHARS command specifies the block- 
continue characters. The choice of characters depends on 
which characters the host expects. The factory default 
block-continue Character for both transmit and receive is the 
ampersand (&). 


BENDCHARS 


The BENDCHARS command specifies the end of a block. 
The block-end character must be compatible with the host 
software. 


SLINELENGTH 


The BLINELENGTH command sets the block line length in 
characters. The default block line length is 70. There is no 
maximum line length for the terminal, since it can receive a 
line of any length. The block line length should not be set to 
a value that exceeds the input buffer of the host. 
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BPACKING 


There are various data packing schemes available for host 
systems with limited transmission capabilities. That is, if 
your host cannot transmit full 7-bit ASCII or 8-bit binary 
data, the data can be coded (packed) into a reduced charac- 
ter set. 


The BPACKING command Specifies the data packing 
scheme. 


BTIMEOUT 


When the terminal sends a block of data, it waits fora 
response from the host to acknowledge that it has received 
that block intact. If the terminal does not receive the appro- 
priate response within the specified period of time, or if it 
receives an erroneous response, the terminal retransmits 
that block. It pauses again, and will repeat the sending of 
the block until it is acknowledged. 


The BTIMEOUT command specifies the period of time the 
terminal waits before sending the block again. Be sure that 
the specified timeout period is longer than may be encoun- 
tered due simply to a busy host. 


BNONXMTCHARS and BMASTERCHARS 


In Block mode, characters that are used for controlling 
block mode (block-continue character, block-end charac- 
ters, etc.) may also appear in text. For example, suppose 
the ampersand (&) is designated as the block-continue 
character. Any occurrence of & in the data transmission will 
be interpreted as the block-continue character. Even though 
characters are chosen for block control that do not often 
occur in text, yet they may occasionally be needed as valid 
text characters. 
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To allow this, characters used for block mode control that 
may also occur in text are designated as non-transmittable, 
meaning that they cannot be transmitted directly as text 
characters. When a non-transmittable character occurs in 
text, it is encoded as a two-character sequence consisting 
of a master character and a substitute character. When this 
two-character sequence is received, it is then decoded as 
the correct text character. 


The BMASTERCHARS command sets the master charac- 
ter; the BNONXMTCHARS command specifies the non- 
transmittable characters. The receive master character and 
non-transmittable characters may be different from the 
transmit characters. 


HALF DUPLEX MODE 


In Full Duplex mode, the terminal and host can both send 

and receive data at the same time. The standard mode of 

communication is Full Duplex. This includes when the ter- 
minal is in Prompt mode or Block mode. 


In Half Duplex mode, the terminal and host can send and 
receive data, but not at the same time. All of the standard 
communications commands are meaningful in Half Duplex 
mode. 


When the terminal is in Half Duplex mode with Supervisor 
Communications mode, the host always controls the flow of 
data; that is, the host decides when the terminal or host 
sends or receives data. 
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Section 6 


SETUP COMMANDS 


Setup commands allow you to establish the terminal’s oper- 
ating environment and to uSe peripherals attached to the 
terminal. For example, setup commands are used to set 
communications rates, inquire about the terminal’s status, 
determine what level of errors should be displayed, confi- 
gure communications ports for the needs of particular 
peripheral devices, and program special meanings 
(macros) into keys. 


The terminal must be in Setup mode to execute setup com- 
mands. Only the operator can place the terminal in Setup 
mode or remove it from Setup mode. To place the terminal 


in Setup mode, press the SET UP key (Figure 6-1). The red 
light in the key glows to show that the terminal has entered 
Setup mode. To remove the terminal from Setup mode, just 
press the SET UP key again; the light in the key goes off to 
show that Setup mode has been terminated. 


This section contains an explanation of Setup mode and 
description of each English-style setup command. Table 6-1 
summarizes the setup commands by functional groups. The 
Command Dictionary part of the section describes each 
setup command in detail, with commands listed in alphabet- 
ical order. 


SET UP 


4665-34 


Figure 6-1. The SET UP Key. 


4115B OPERATORS 


REV, JAN 1984 6-1 


SETUP COMMANDS 


SETUP MODE 


Setup mode interacts with other terminal modes and func- 
tions in various ways. 


Host Communications. Communication to the host com- 
puter is suspended when the terminal is in Setup mode. 
Data sent from the host is stored in an input queue and 
processed when the terminal leaves Setup mode. (The size 
of this queue is set by the QUEUESIZE commana.) 


GIN Mode. When the terminal enters Setup mode, GIN 
mode is suspended. The GIN cursor disappears and 
graphic input is not processed. When the terminal leaves 
Setup mode, the cursor reappears and GIN mode con- 
tinues. See the 4/10 Series Host Programmers Manual and 
the 4110 Series Command Reference Manual for details on 
GIN mode. 


Control Characters. In Setup mode, most control charac- 
ters are displayed rather than executed. Control characters 
are displayed as two-character snoopy characters; for exam- 
ple, the Escape character is displayed as ®c. 


Programmed Keys. If the terminal is in Setup mode and 
you press a key that has a macro programmed into it, the 
macro is expanded as usual. (See the DEFINE command 
description later in this section.) 


Local Mode. When the lights in both the SET UP and 
LOCAL keys are on, both Setup and Local modes are set. 


Data is echoed locally only, instead of being sent to the host. 


ESCAPE SEQUENCE COMMANDS 


In this manual, the term setup command refers only to the 
English-style commands documented in this section. Only 
those commands that are most useful to a typical operator 
have English-style setup names. The terminal also 
responds to escape sequence commands, whether it is in 
Setup mode or not. These commands include equivalents 
for all of the English-style setup commands (in a different 
command format), as well as a large number of other com- 
mands to control the terminal. 


Each escape sequence command begins with the ASCII 
Escape character §c, followed by a two-character op-code. 
The command may include one or more parameters that 
define the exact action of the command. Appendix C con- 
tains a list of all escape sequence commands. The 4/10 
Series Command Reference Manual contains detailed 
descriptions of all such commands. 


SETUP MEMORY 


The terminal stores many setup command parameters in 
setup memory. When the terminal is turned on, it remem- 
bers these parameters. This saves you the trouble of reset- 
ting basic operating parameters each time you turn on the 
terminal. 


The STATUS command will display one, some, or all of the 
setup command parameters. See the STATUS command 
description later in this section. (STATUS also works with 
escape sequence commands.) 


Table 6-1 lists all setup commands by functional groups. 
Included is the command name, the factory default settings 
of the parameters set by the command, and a brief descrip- 
tion of the purpose of the command. A superscript (°) follow- 
ing acommand name indicates that the parameters set by 
the command are stored in setup memory and remembered 
when the terminal is turned off and back on again. In the 
command dictionary portion of this section, the notation 
(Memory) after the command purpose indicates the same 
thing. | 


SETUP COMMAND SUMMARY > 


Table 6-1 lists and briefly describes all setup commands. It 
also indicates the factory default parameter values, which 
commands are part of options to the terminal, and those 
commands whose parameters are stored in setup memory. 
The factory default is shown for each parameter because 
that is the value the terminal assumes if the setup memory 
fails or is changed by the addition or deletion of a circuit 
board. 
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Function 


General Terminal 
Operation 


Dialog Area 
Control 


Table 6-1 
SETUP COMMANDS 


CMAP See Table 6-2 


CMODE 3 1 1 (See Table 6-3) 
CODE TEK 


CRLF? NO 
DEFINE 
ECHO? NO 

EDITCHARS RUBOUT Cn, ~ 


No default 


ERRORLEVEL 
FIXUP 


GAMODE? 


IGNOREDEL? 


KEYEXCHAR? 

LFCR?@ 

LOCKKEYBOARD 

PAGEFULL? NONE 


RENEW No default 
SNOOPY NO 


STATUS No default 


DABUFFER® 
DACHARS? 


DAENABLE? 


DAINDEX? 

DA2INDEX? 

DALINES? 

DAMODE? REPLACE 
DAPOSITION? 0,0 
DASURFACE? 1 

DAVIS? NO 


SETUP COMMANDS 


Explanation Factory Default Purpose 


Determines mapping from a surface’s color indices to 
particular color mixtures. 


Sets the color mode parameters. 


Selects the command syntax to which the terminal will 
respond. 


Sets or terminates “carriage return implies line feed.” 
Assigns macro to key or integer. 
Sets local or remote echo. 


Defines character delete, line edit, and literal 
characters. 


Sets error reporting threshold. 


Determines how thoroughly the viewport is updated 
when a change is made that affects it. 


Determines if background of character is visible when 
text is displayed in graphics area. 


Specifies whether or not the ASCII delete character is 
ignored. 


Specifies the key execute toggle character. 
Sets or terminates ‘“‘line feed implies carriage return.” 
Locks the keyboard. 


Determines action to be taken when pagefull condition 
occurs. 


Erases view and redraws all visible segments. 
Sets or terminates snoopy mode. 


Displays the terminal’s status. 


Sets maximum size of dialog buffer in lines. 


Sets maximum number of characters per line in the 
dialog area. 


Specifies whether or not alpha text is sent to the dialog 
area. 


specifies the display colors in the dialog area. 
Specifies the color to use for Graphic Rendition 1. 
Specifies the visible portion of the dialog buffer. 
Sets Overwrite or Replace mode in dialog area. 
Sets position of dialog area. 

Sets dialog area surface. 


Sets visibility of the dialog area. 


* Parameter is stored in setup memory; the terminal remembers the parameter setting when the terminal is turned off and then on again. 
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SETUP COMMANDS 


Function 


File Transfer 
Control 


Graphic Input 
(GIN) 


Standard 
Communications 


Table 6-1 (cont) 
SETUP COMMANDS 


Explanation Factory Default Purpose 


No default 
No default 
No default 
No default 


No default 


GINAREA | No default 


GINCURSOR No Default 
GINDISABLE No default 
GINENABLE | No default 


GINGRIDDING | No default 
GININKING | No Default 
GINPICKAPERTURE 8 

GINRUBBERBAND No default 
GINSTARTPOINT | No default 


GINWINDOW 0,0 
. 4095, 4095 


REOM? | | 1 


RLINELENGTH 0 
RSIGCHARS No default 


BAUDRATE® 2400, 2400 
BREAKTIME® | 

BYPASSCANCEL? 

EOFSTRING?# ’’ (empty string) 
EOLSTRING? bY 
EOMCHARS® Cale 
FLAGGING? | NONE 

PARITY 2 | NONE 
PROMPTMODE | NO 
PROMPTSTRING? ’’ (empty string) 


QUEUESIZE? 
STOPBITS? 
XMTDELAY 2 


XMTLIMIT 2 


Copies data from one device to another. 
Reads a file and executes it as a command file. 
Saves macro, segment, or pixels to a disk file. 


Copies data from one device to another, leaving the 
terminal free to do other jobs at the same time. 


Halts the spooling operation. 


Maps an area ona GIN device to a specified screen 
area. 


Selects a segment to use as the GIN cursor. 
Disables a specified GIN combination. 


Enables GIN mode for a specified device and number of 
GIN events. 


Establishes a grid for GIN input. 

Turns inking on or off. 

Specifies tolerance for picking objects. 

Turns rubberbanding on or off. 

Specifies starting point for inking and rubberbanding. 


Sets a window in terminal space for GINAREA. 


Determines use of end-of-message character for GIN 
mode. | 


Determines GIN report line length limit. 


Assigns signature characters for GIN reports. 


Sets transmit and receive baud rates. 

Defines length of break transmission in milliseconds. 
Sets bypass cancel character. 

Defines end-of-file string. - 

Defines end-of-line string. 

Defines end-of-message characters. 

Specifies kind of flagging done by the terminal. 
Specifies the kind of parity sent from the terminal. 
Specifies whether or not the terminal is in Prompt mode. 


Specifies prompt used when terminal is in Prompt 
mode. 


Sets size of terminal input queue. 
Specifies number of stop bits the terminal uses. 


Specifies length of time terminal waits after receiving 
end-of-message character. : 


Specifies maximum transmit rate for the terminal. 


. Parameter is stored in setup memory; the terminal remembers the parameter setting when the terminal is turned off and then on again. 


6-4 


REV, JAN 1984 


4115B OPERATORS 


Function 


Optional 
Communications 
(Option 01) 


Three Port 
Peripheral 
Interface Control 
(If Option 10 is 
installed, all three 
ports are the same 
on CMOS reset.) 


Graphic Tablet 
(Options 13 and 14) 


Table 6-1 (cont) 


SETUP COMMANDS 


BCONTINUECHARS? & & 
BENDCHARS? $$ 


'HEADTX’ 
'HEADRX'’ 


BHEADERS? 


BLENGTH? 256 256 
BLINELENGTH? 70 


BLOCKMODE? No 


BMASTERCHARS? # # 
BNONXMTCHARS? HSE! FSR! 
BPACKING? 7676 
BTIMEOUT @ 0 


DUPLEX? 


PASSIGN? PPORT 
PBAUD? 2400 
PBITS?# 18 
PCOPY 
PLOT 

PEOF* 
PEOL? 
PFLAG? 
PMAP 
STATUS 3PPI 
PPARITY # 


No default 
No default 


"(empty string) 


‘’ (empty string) 
NONE 


No default 
No default 
NONE 


TBFILTER No default 
TBHEADERCHARS 
TBSIZE 


TBSTATUS IN 


LETTERS 
AUTOMATIC 


SETUP COMMANDS 


Purpose 


Specifies block-continue characters. 
Specifies end-of-block characters. 


Specifies block-header sequences. 


Specifies block length. 
Specifies line length for Block mode transmission. 


Specifies whether or not terminal is armed for Block 
mode. 


Specifies master characters for Block mode. 
Specifies nontransmittable characters for Block mode. 
Specifies manner in which blocks are packed. 


Specifies how long terminal waits before retransmitting 
previous block of data. 


Specifies which Duplex mode the terminal is in. 


Assigns a device to a port. 

Sets baud rate for a port. 

Sets the stop and data bits for a port. 

Copies between peripheral devices and the host. 
Plots currently visible segments to specified device. 
Defines the end-of-file string for a port. 

Defines the end-of-line string for a port. 

Establishes type of flagging for a port. 

Assigns a color index to a plotter pen. 

Returns status on peripheral ports. 


Establishes the parity checking used on a port. 


Specifies tablet data filtering. 
Specifies tablet stroke header characters. 
Selects size of active area on tablet. 


Specifies if status byte is sent when input device is lifted 
from tablet surface. 


a 
Parameter is stored in setup memory; the terminal remembers the parameter setting when the terminal is turned off and then on again. 
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Function 


Disk Control 
(Options 42, 43, and 45) 


Color Copier Interface 
(Option 09) 


Local Programmability 
(Option 42,43) 


Table 6-1 (cont) 
SETUP COMMANDS 


DELETE No default 
DIRECTORY No default 
DISMOUNT No default 
FORMAT No default 
PROTECT No default 


RENAME No default 


USERNUMBER No default 


HCCOPIES 


HCDATARES? 


HCINTERFACE? MONO 


HCORIENT 4 
HCRESERVE | NO 


LPOS No default 


HORIZONTAL 


Deletes a file from the disk. 

Displays a directory of the disk. 

Tells the terminal that a disk has been replaced. 
Prepares a disk so files can be created on it. 


Prevents the terminal from writing to a specified disk 
file. 


Renames a disk file. 


Sets a user number for file access. 


Sets number of color hard copies made by each 
hardcopy request. 


Sets either one- or two-byte resolution for color hard 
copy. 


Selects either monochrome or color hardcopy interface 
for subsequent hardcopies. 


Sets image orientation on color hardcopy media. 


Specifies whether the terminal reserves the attention of 
a multiplexed color copier. 


Activates local programmability. 


* Parameter is stored in setup memory; the terminal remembers the parameter setting when the terminal is turned off and then on again. 
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SETUP COMMAND STRUCTURE 


Each English-style setup command begins with a command 
word, includes zero or more parameters, and ends witha 
Carriage Return. 


The comand word is a descriptive English-like word that 
tells the terminal which command Is being entered. The 
command words have been chosen to remind you of the 
action of the command; for example, SNOOPY controls 
Snoopy mode, BAUDRATE sets the terminal’s baud rates, 
and so on. 


A setup command word can be entered in either upper or 
lower case letters. (NOTE: Upper and lower case are not 
interchangeable in escape sequence commands.) A com- 
mand word can be abbreviated to as few characters as 
necessary to distinguish it from other commands. For exam- 
ple, the DAINDEX command word can be entered as just 
DAI; it cannot be shortened to DA since several other com- 
mands also begin with these characters. 


Most commands include one or more parameters — num- 
bers, characters, or strings that define the exact action of 
the command. For example, to set the rate at which the 
terminal transmits and receives information, enter the 
BAUDRATE command followed by the two rates: 


BAUD 2400 9600 


The “2400” and “9600” are the parameters that define the 
exact action of the BAUDRATE command (here abbreviated 
to BAUD). 


There are eight types of parameters that may be included in 
various commands. 


integers. An integer is simply a whole number. The range 
for each integer parameter is given in the specific com- 
mand. 


Heais. Areal parameter is a decimal number in the range 
from -32767.0 to + 32767.0. (Setup commands will accept 
only integer parameters and not decimal or real numbers. 
some escape commands, however, accept real numbers as 
valid parameters.) 
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Arrays. An array is asequence of integers or reals. For 
example, the CMAP command accepts an integer parame- 
ter followed by an array of integers. 


Single Characiers. You can specify a single character in 
one of three ways: 


© Press the appropriate key. This works for all printing 
alphanumeric characters. For example, to set the key- 
execute delimiter to +, give the cornmand KEVYEXC?FAA 


© Enter the ADE (ASCII Decimal Equivalent) of ine charac- 
ter. For example, KEYEXCHAR 43 seis the key-execute 
delimiter to + whose ADE Is 43. 


Each ADE is a two- or three-digit number. To enter ADES 
less than 10, precede the digit by a zero. For example, 
G8 indicates ADE 8, the Back Space character; & ind!- 
cates the number 8 (with ADE 56). Refer to the ASCII 
Code Chart appendix. 


© To enter a control character tnat is normally executed, 
precede the character by a /iferal character (see the 
EDITCHARS command description). The factory default 
literal character is a ~ (tilde). For example, to entera 
Carriage Return in a DEFINE command, enter ~ °r. The 
tilde causes ihe terminal to display the Carriage Return 
as a two-character Snoopy mnemonic rather than exe- 
cute it. 


Key Specitiers. A key specifier indicates a particular key on 
the terminal keyboard. For alphanumeric keys, just press 
the key or enter the ADE (as you would to enter a single 
character). To specify a function key, use one of the follow- 
ing key specifiers: 


F1—F8 
S1—S8 


Function keys 1 through 8 
Shifted function keys 1 through 8 


NOTE 


BE SURE TO ENTER THE CHARACTERS “fF” 
“1” (for example). Pressing the F!] key will simply 
execute the current macro assigned to that key. 
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Keywords. A keyword is just a sequence of alphanumeric 
characters that you enter as shown. Keywords, like com- 
mand words, can be abbreviated. For example, to put the 
terminal in Snoopy mode, enter: SNOOPY YES or just 
SNO Y. 


Undelimited Strings. These are simply strings of ASCII 
characters. They are entered just like keywords. The differ- 
ence is that keywords are predetermined strings that the 
terminal expects to see — like YES or NO. An undelimited 
string can be any string that you choose (subject, of course, 
to the requirements of the particular commana). All string 
parameters are undelimited unless otherwise noted. 


Delimited Strings. A delimited string is a string of charac- 
ters that is preceded and followed by the same delimiter. 
The delimiter is a character that tells the terminal where the 
character string begins and ends. The delimiter can be any 
character except a Space, Comma, or one of the Edit char- 
acters (see EDITCHARS). Generally, when the terminal 
expects a delimited string it assumes that the first alphanu- 
meric character that is not a Space, Comma, or Edit charac- 
ter is the delimiter for the string. For example, to program 
the + key to generate the string Hi There!, you could enter 
the following: 


DEFINE + /Hi There!/ 


Here, the “/” is the delimiter for the string Hi There!. 


A “command line” can be up to 130 characters long. If you 
continue typing past the right margin of the screen, the 
cursor just “wraps around” to the left margin of the next line 
on the screen and the extra characters are displayed on that 
line. The command line continues until you press the Rtn 
key. If you keep typing after the maximum of 130 characters, 
the terminal ignores the extra input and rings the terminal 
bell each time you press a key. This continues until you end 
the command by pressing Rtn or delete some of the input 
(see the Correcting Errors discussion that follows). 


Command Terminator. Each setup command must be 
terminated by a Carriage Return. This terminates the input 
line and causes the terminal to execute the command. This 
terminating Carriage Return is shown in the command 
examples as ©r; for example: 


BAUD 2400 9600°r 
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DEVICE NAMES AND FILE NAMES 


Several commands in this section take device names or file 
names as parameters. These are always undelimited 
strings. Both device names and file names must conform to 
the conditions given under the following headings. 


Device Names 


The terminal has two optional flexible disk drives. Option 42 
includes one drive; Option 43 includes two drives. Both of 
these options include Option 45, the Mass Storage Inter- 
face; Option 45 can also be installed separately. Option 45 
allows the terminal to address several external mass stor- 
age drives. 


Several of the terminal’s commands allow you to access 
one of these as either a source device or a destination 
device, or a file on one of these devices. 


Unless otherwise noted, valid device names are: 


HO: ~ Host communications port. 


FO: Flexible disk drive 0. (Option 42 or 43). This is 
the default drive; if you specify a filename 
without a device name, device FO: is assumed 


F1: Flexible disk drive 1. (Option 43) 
SO: — S7: 
~ T0:—T7: 
U0: — U7: 
V0: — V7: External mass storage devices (Option 45) 


WO: — W7: ( orhard disk drives (Options 46 or 47)' 
XO: — X7: 
YO: — Y7: 
Z0: — Z7: 


The default device is FO:. That is, the following two com- 
mands are equivalent: 


COMMAND filename 
COMMAND F0:filename 


4 
The specific device name for an Option 45, 46, or 47 device depends on strap 
settings that are set during installation. 
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Other device names are inc!uded with Option 09 (Color 
Copier Interface) and Option 3A (DMA Interface): 


HC: A hard copy device 
(destination only; Option O09) 
SC: Screen contents (source only; Option 09) 
DM: The DMA interface (Option 3A) 
SG: 
PX: 
CM: Pseudo-devices (Option 3A) 
DS: } 


Refer to the COPY command discussion in the 4//0 Series 
Command Reference Manual for details. 


File Names 


A file name consists of two parts: aname and an optional 
extension. If an extension is used, the name and extension 
are separated by a period. 


Tne name must be from one to eight characters long. Any 
printing ASCII characters (ASCII decimal equivalents 33 
through 126) can appear in a name, except the following: 


Character ADE (ASCII Decimal Equivaleni) 


* 42 
44 
46 
58 
59 
60 
62 
61 
63 
91 
93 
Underscore 95 


RBS Se ae RR FS 
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An extension can be from one to three characters in length. 
If the file name includes an extension, you must specify that 
extension when you reference the file in a command. The 
same character restrictions apply to extensions as to file 
names. 


Some examples of valid file names are: 


MACRO244 
DATA-NEW 
junk 
83status.tmp 
87-plan.dat 
new.bas 


The terminal stores file names in all uppercase, although 
you can enter a filename as either lowercase or uppercase 
characters. 


CORRECTING ERRORS IN SETUP 
COWIMANDS 


lf you make an error while entering a setup command, you 
can do one of three things. 


© |f you have not yet pressed the Rtn key, you can enter the 
linedel (line-delete) character to erase the current line. 
The factory default linedel character is Sn (the ASCII 
Cancel character, ADE 24); to enter this character, enter 
Ctrl-X — that is, hold down the Ctrl key and press X. 


O If you have not yet pressed the Rtn key, you can use the 
chardel (character-delete) character to erase the charac- 
ters, one by one, back to the error, then finish the line 
correctly. The factory default chardel character is the 
ASCII Delete character (ADE 127); to enter this character 
press the Rub Out key. 


O Reenter the correct form of the command. If you have 
already pressed the Rtn key, you cannot repair the com- 
mand. The terminal will execute the command, if it can; If 
it cannot, you will see an error message on the screen. 
You can usually just reenter the correct command. 
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COMMAND SYNTAX 


Figure 6-2 shows the format used throughout the rest of this 
section to present command syntax and descriptions. 


Each command description begins at the top of a column. 
The column heading is the command name. If the command 
requires or is part of any option(s), this is shown just after 
the command name. 


Following the command name is a brief statement of the 
purpose of the command. If the parameters set by the com- 
mand are saved in setup memory (and remembered when 
the terminal is turned back on), the word Memory appears 
just after the statement of purpose. 


The next line shows the command syntax. This is the 
abstract form of the command, showing the type and order 
of parameters, and which ones are required and which are 
optional. The following conventions are used: 


@ The command word is shown first, completely spelled 
out, in all capitals and in bold. 


@ Words that must be entered exactly as shown — com- 
mand words and parameters — are shown in bold type, 
like this. However, all such entries can be abbreviated to 
their shortest unambiguous form. For example, you can 
enter the command SNO Y for SNOOPY YES. 


@ Parameters in regular type are actually parameter names 
that describe the parameter to be entered. For example, 
consider the command syntax: 


BAUDRATE trans rec 


Here the parameter names trans and rec are chosen as a 
reminder that the first parameter you enter specifies the 
transmit baud rate, while the second specifies the 
receive baud rate. 
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@ Parameters are separated from the command word and 
from each other by spaces or commas. You can use 
more than one space to separate parameters, but 
repeated commas signify omitted parameters (before the 
last). For example, consider the command: 


GINGRIDDING 1,,100 


This command indicates that the second parameter is 
omitted and that the default value will be assumed. 


@ Parameters in square brackets — [like this] — are 
optional. 


@ When parameters are stacked in braces — ae — it 


means that you must choose one from the list. When 
parameters are stacked in square brackets in this way, 
you may choose one, but need not choose any (that is, a 
default is provided). 


@ When there are several variations of the syntax, two or 


more syntax statements are used for greater clarity. 


Figure 6-2. Command Syntax Format. 
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BAUDRATE 


Specifies the transmitting and receiving baud rates for 
communications between the terminal and the host 
computer. 

(Memory) 


RAUORATE trans, rec 


trans is an integer parameter specifying the baud rate 
at which the terminal transmits data. A value of 1 
indicates the use of an external device to control the 
transmission rate. The factory default transmit baud 
rate is 2400. 


rec is an integer parameter specifying the baud rate 
at which the terminal expects to receive data from the 
host. A value of 1 indicates external clocking. If you 
enter no value or aO for “rec’’, itis set to the same 
value as “trans.” The factory default for “rec” is 2400. 


Valid baud rates for both “trans” and “rec” are: 
1 (external clocking) 
50 
75 


(sets baud rate to 134.5) 
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BAUDRATE 


NOTE 


The terminal’s baud rate settings must be compati- 
ble with the transmit and receive baud rates used by 
the host computer. 


The transmit and receive rates do not have to be set to the 
same values. Also, either the transmit or receive rate can be 
specified by an external clock while the other is specified by 
the terminal firmware. 


The following command sets the transmit rate to 9600 baud 
and the receive rate to 2400 baud. 
BAUDRATE 9600, 2400 °r 


The following command sets the transmit baud rate to 2400 
while the receive baud rate is controlled by an external 
clock. 


BAUDRATE 2400 1 Cr 


The baud rate parameter may be set for you by an initializa- 
tion file on a disk. If itis not, you may need to consult with a 
system programmer for your host computer before using 
this command. 


6-11 


SETUP COMMANDS 
BCONTINUECHARS, BENDCHARS 


BCONTINUECHARS (Option 01) 
Sets the line continue characters for Block mode. 
(Memory) 


BCONTINUECHARS xmt,rec 


xmt is a single character representing the transmit 
continue character. If “xmt’ is omitted, it is set to null 
(ADE 0). Any ASCII character is valid; the factory 
default is an ampersand (&). 


rcv is an single character representing the receive 
block continue character. If “rcv” is omitted, it is set to 
null (ADE 0). Any ASCII character is valid; the factory 
default is an ampersand (&). 


If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


If you enter just the command word and no parameters, 
both ‘‘xmt” and “rcv” are set to the null character (ADE 0). 


The terminal sends the “xmt” character to the host to indi- 
cate when a block continues to the next line. When the 
terminal receives the “rcv” block continue character, the 
terminal knows that the block it is receiving continues to the 
next line. 


The following command specifies the percent (%) as the 
transmit block continue character and the asterisk (*) as the 
receive block continue character: 


BCONTINUECHARS % * Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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BENDCHARS (Option 01) 
Sets the block end characters for Block mode. 
(Memory) 


BENDCHARS xmt, rcv 


xmt is a single character representing the transmit 
block end character. If “xmt” is omitted, it is set to null 
(ADE 0). Any ASCII character is valid; the factory 
default is the dollar sign ($). 


rcv is a single character representing the receive 
block end character. If ‘‘rcv” is omitted, it is set to null 
(ADE 0). Any ASCII character is valid; the factory 
default is the dollar sign ($). 


If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


If you enter just the command word and no parameters, 
both “xmt” and “rcv” are set to the null character. 


The terminal transmits the “xmt” character to the host to 
indicate the last line of a transmission in Block mode. When 
the terminal receives the “rcv” character, the terminal 
knows that it is the last line of a block transmission. 


The following command sets the block end transmit charac- 
ter to the pound sign (#) and the block end receive character 
to the ampersand (&): 


BENDCHARS # & Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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BHEADERS (Option 01) 
Sets the transmit and receive header sequences for Block 
mode. 

(Memory) 


BHEADERS °:xmt®., OcreveL 


Di is the delimiter character. The same character must 
precede and follow each parameter. The first charac- 
ter after the command word that is nota comma, a 
space, or an edit character (see EDITCHARS) is taken 
as the delimiter character for this command. 


BLENGTH 


SETUP COMMANDS 
BHEADERS, BLENGTH 


Option 01) 


Sets the block length for Block mode. 
(Memory) 


BLENGTH xmt, rcv 


xmt is an integer parameter representing the transmit 
block length. The valid range of values is from five to 
65535 characters. The factory default is 256. 


rcv is an integer parameter which is the receive block 
length value. The values range from five to 65535 


characters. The factory default is 256. 


xmi is a string of up to ten ASCII characters that spec- 
ifies the transmit block header sequence. Any charac- 
lf the terminal is already armed for Block mode, this com- 

mand generates an error. See the BLOCKMODE command. 


ter except those listed under Restrictions can be used 
in the string. If “xmt” is omitted, it is set to the null 
character (ADE 0). The factory default is “HEADTX”. 


The following command sets the block length to 100 for both 
rcv is a string of up to ten ASCII characters that speci- xmt and rcv: 

fies the receive block header sequence. Any charac- a 
ter except those listed under Restrictions can be used SE Nees 100; Ie 

in the string. If “rcv” is omitted, it is set to the null 
character (ADE 0). The factory default is “HEADRX”. 


R 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 


Restrictions. The “xmt” and “rcv” strings should not con- 
tain the delimiter character or any characters that appear in 
the prompt string. In addition, the “xmt” and “rcv” strings 
should be ones that do not normally appear in text. 


lf the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


If you enter just the command word and no parameters, 
both “xmt” and “rcv” are set to the null string. 


When the terminal sends the “xmt” sequence, it signals the 
host that a block of packed data follows immediately. When 
the terminal receives the “rcv” sequence, it signals the 
terminal that a block of packed data follows immediately. 


The following command sets the transmit block header to 
‘“+ send” and the receive block header to “ + recve”: 


BHEADERS /+send/ /+recve/ Sr 


This parameter may be set by an applications program on 
the host computer or by an initialization file ona 

disk. If itis not, you may need to consult with a system 
programmer for your host computer before using this 
command. 
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BLINELENGTH, BLOCKMODE 


BLINELENGTH (Option 01) 
Specifies the maximum length line that the terminal will 
transmit in Block mode. 

(Memory) 


BLINELENGTH length 


length is an integer parameter specifying the maxi- 
mum number of characters the terminal can transmit 
in one line in Block mode. The valid range is from 

12 to 65535 characters. The factory default is 70 
characters. 


If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


The specified line length has no effect on input to the termi- 

nal for communications in non-Block mode. 

The following command sets the line length to 55: 
BLINELENGTH 55 Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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BLOCKMODE (Option 01) 
Arms the terminal for Block mode; that is, it specifies that 
the terminal will go into Block mode as soon as it receives 
the block header sequence. 

(Memory) 


BLOCKMODE {yes 
io 


yes is a Keyword parameter that arms the terminal for 
Block mode. This means that the terminal will enter 
Block mode when it receives the next block header 
sequence (see BHEADER). If you enter just the com- 
mand word and no parameter, the terminal assumes 
“yes” and arms itself for Block mode. 


no is a keyword parameter specifying that the termi- 
nal is not in Block mode. If the terminal is in Block 
mode when you enter this command, it exits from 
Block mode immediately. This is the factory default. 


Attempting to arm the terminal for Block mode 
when it is already in Block mode will cause com- 
munications difficulties with the host computer. 


The following command causes the terminal to enter Block 
mode: 


BLOCKMODE yes Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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BVIASTERCHARS (Option 01) 
Sets the master characters for Block mode. 
(Memory) 


BMASTERCHARS xmt, rec 


xmt is a single character that is the transmit “master 
character” for Block mode. If you do not enter a value 
for “xmt” itis set to null. Any ASCII character is valid; 
the factory default is the pound sign (#). 


rcv is a single character representing the receive 
“master character’ for Block made. If you do not 
enter a value for “rcv” it is set to null. Any ASCII char- 
acter is valid; the factory default is the pound sign (#). 


If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


If you enter just the command word and no parameters, 
both “xmt” and“rcv” are set to null. 


The following command sets the transmit master character 
to an asterisk (*) and the receive master character toa 
dollar sign ($): 


BMASTERCHARS * $ Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
BVMASTERCHARS, BNONXMTCHARS 


BNONXMT CHARS (Option 01) 
Sets the non-transmittable characters for Block mode. 
(Memory) 


BNONXMTCHARS °rxmt?L, PrreveL 


D: is the delimiter character. The same delimiter char- 
acter must precede and follow each parameter. The 
first character after the command word that is nota 
comma, space, or edit character (see EDITCHARS) is 
the delimiter character for this command. 


xmt is a String of up to 20 ASCII characters that speci- 


fies the non-transmittable characters for output in 
Block mode. The factory default string is the pound 
sign, dollar sign, and ampersand (#$&). 


rcv is astring of up to 20 ASCII characters that speci- 
fies the non-transmittable characters for input in 
Block mode. The factory default string is the pound 
sign, dollar sign, and ampersand (#$&). 


If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


If you enter just the command word with no string for either 
“xmt” or “rcv’’, both are set to null. 


A character is to be “‘non-transmittable” because it has a 
special Block mode meaning to the terminal (Such as the 
block continue, block end, or block master characters) or 
host. See the discussion of Block mode in the Host Com- 
munications Overview section. 


The following command sets the plus sign (+ ) and percent 
sign (%) as non-transmittable characters for both transmit- 
ting and receiving: 


BNONXMTCHARS '+%’ '+%' rR 


These characters may be set by an applications program on 
the host computer or by an initialization file on a disk. If they 
are not, you may need to consult with a system programmer 
for your host computer before using this command. 
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BPACKING, BREAKTIME 


BPACKING (Option 01) 
Sets the transmitting and receiving packing values for Block 
mode. 

(Memory) 


BPACKING xmt, xmtpack, rcv, rcvpack 


xmt must be set to either 7 or 8 bits. It specifies the 
size of each byte that is transmitted. The factory 
default is 7 bits. 


xmtpack must be set to 6, 7, or 8. It specifies the 
number of data bits per byte that is transmitted. The 
factory default is 6. 


rcv must be set to either 7 or 8. It specifies the size of 
each byte received from the host. The factory default 
is 7. 


rcvpack must be set to 6, 7, or 8. It specifies the num- 
ber of data bits per byte that is received. The factory 
default is 6. 


If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


The following command sets the “xmt” value to 8, the “xmt- 
pack” value to 7, the “rcv” value to 8, and the “rcvpack” 
value to 7: 


BPACKING 8 7 8 7 &rR 


These parameters may be set by an applications program 
on the host computer or by an initialization file on a disk. If 
they are not, you may need to consult with a system pro- 
grammer for your host computer before using this. 
command. 
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BREAKTIME 


Specifies the length of the break transmission. 
(Memory) 


BREAKTIME ms 


ms is an integer parameter specifying the length of 
the interrupt, in milliseconds. The valid range is from 


0 to 65535. The factory default is 200 ms. Setting 
“ms” to 0 means that no break transmission is sent. If 
you do not enter any value for the parameter, it is set 
to zero. 


When you press the Break key, an interrupt is sent by the 
terminal to the host. The purpose of the interrupt is to halt 
execution of a host resident program or transmission of data 
from the host. | 


Different host computers may require different length inter- 
rupts. The length of the interrupt sent by the terminal is 
determined by the BREAKTIME command. 


The following command sets BREAKTIME to 400 ms. 


BREAKTIME 400 Cr 


Since the interrupt is handled differently by different hosts, 
you should check with a system programmer for your host 
before using the BREAKTIME command or the Break key. 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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BTIMEOUT 


(Option 01) 
Determines how long the terminal will wait for a response 


from the host before retransmitting the previous block. 
(Memory) 


BITIMEOUT seconds 


seconds |s an integer parameter specifying the num- 
ber of seconds the terminal will wait before it retrans- 


mits a block of data. Valid values are from 0 to 65535; 
a setting of O disables the feature. lf you do not enter a 
value for the parameter, it is set to zero. The factory 
default is zero. 


lf the setting is too long, you would have to wait along time 
to become aware that there was a problem such as a block 
being lost. If it is too short, the terminal might try to send a 
block again just because the host was slow to respond. 
Setting it to zero disables the timeout feature. 


The following command sets BTIMEOUT to 2 seconds: 


BTIMEOUT 2 Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If itis 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
BTIMEOUT, BYPASSCANCEL 


BYPASSCANCEL 


Specifies the bypass cancel character. 
(Memory) 


BYPASSCANCEL char 


char is an undelimited single ASCII character. This 
parameter is usually set to either ‘r (line feed) or Cr 


(carriage return). The factory default is ‘rf. If no charac- 
ter is specified the parameter is set to the null charac- 
ter (ADE 0), and the bypass feature is turned off. 


Remote echo computers use Bypass mode to suppress the 
echoing of unnecessary control characters. The terminal 
uses the bypass cancel character to get out of Bypass 
mode. 


The following command sets the bypass cancel character to 
carriage return. The “tilde” before the first carriage return is 
the literal character (see EDITCHARS). 


BYPASSCANCEL ~r Sr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If itis 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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CMAP 


CMAP 


The ranges for these color coordinate systems are as 


Determines the mapping from a surface’s color indices to ronows: 


particular color mixtures. 
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CMAP surface-number, quadruple 


surface-number is an integer with one of the follow- 
ing values: 


A supersurface consisting of all the bit 
planes of all other surfaces. 


A valid graphics surface number. The 
surface must be defined. 


quadruple In the command syntax, “quadruple ...”’ 
means one or more groups of four integers. (All the 
quadruples together are considered to be one integer 
array.) Each quadruple consists of four integers, sepa- 
rated by spaces or commas, as follows: 


<color-index> <first-color-coordinate > <second- 
color-coordinate > <third-color-coordinate > 


The integers within a quadruple have the following 


meanings: 


color-index is an integer in the range from 0 to 32767. 
The actual number of color indices is determined by 
the number of bit planes installed. If there are N bit 
planes, the maximum color index is 2“—1. Any color- 
index parameter greater than this maximum is set to 
the maximum. 


A color index of 0 specifies the background color. 


color-coordinates are three integers that specify the 
exact color mixture to which the color-index refers. 
The color coordinates are specified in the HLS,RGB, 
CMY, or Machine RGB color coordinate system, 
whichever was specified in the last CMODE com- 
mand. (The default on power-up is the HLS coordi- 
nate system.) Adding 1000 to the final coordinate of 
any index blinks that color on and off. 


HLS System: 
H (Hue) 
L (Lightness) 
S (Saturation) 


RGB System: 
R (Red) 
G (Green) 
B (Blue) 


CMY System: 
C (Cyan) 
M (Magenta) 
Y (Yellow) 


Machine RGB System: 
R (Red) 
G (Green) 
B (Blue) 


Gray level = 


integer. 
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—32768 to 32767 
0 to 100 

0 to 100 

or 1000 to 1100 


0 to 100 
0 to 100 
0 to 100 
or 1000 to 1100 


0 to 100 
0 to 100 
0 to 100 
or 1000 to 1100 


0 to 255 
0 to 255 
0 to 255 
or 1000 to 1255 


The CMAP command sets the color map for a particular 
surface; that is, it determines the mapping from the color 
indices for that surface to particular color mixtures. 


This command also sets the surface gray levels correspond- 
ing to particular colors, according to the transform: 


(.30)*(Red level) + (.59)*(Green level) 
+ (.11)*(Blue level) 


The resulting gray level value is rounded to the nearest 
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On power-up some of the color indices are assigned to the 
default color mixtures shown in Table 6-2. For terminals with 
more than the minimum number of bit planes installed, 
more default colors will be defined, up to a maximum of 255. 
These are listed in an appendix to the 4//0 Series Command 
Reference Manual. 


The following command defines color index 1 for surface 2 
to be yellow (color coordinates 180, 50, 100) in the HLS 
system. 


CMAP 2 1 180 5C 190 


If the surface has more than one bit plane, more quadruples 
may be added. The terminal will process everything in 
groups of four without regard to separators. For further 
information about the CMAP command, see the <set- 
surface-color-map > command in the 4//0 Series Command 
Reference Manual. 


Table 6-2 
DEFAULT COLORS 

Color | Color - Color Coordinates 
Index Mixture Hi L S 

O Transparent | 

I White 0 100 6) 

2 Red 120 50 100 

3 Green 240 50 100 

4 Blue 0 50 100 

5 Cyan 300 50 100 

6 Magenta 60 50 100 

7 Yellow | 180 50 100 

8 Red-Yellow(Orange) — = 150 50 100 

9 Green- Yellow 210 50 100 
10 Green-Cyan 270 | 50 100 
11 Blue-Cyan 330 i 50 100 
12 Blue-Magenta 30 50 100 
13 Red-Magenta 90 50 100 
14 Dark Gray 0 33 0 
15 Light Gray 0 67 | 0 
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SETUP COMMANDS 
CMAP, CMIODE 


CiMODE 


Sets three color mode parameters for the terminal. 


CMODE color-specifying-mode, color-overlay-mode, 
gray-mode 


color-specitying-mode determines whether the RGB 
(red,green,blue), CMY (cyan, magenta, yellow), HLS 
(hue, lightness, saturation), or machine RGB system 
of color coordinates is used for specifying color mix- 
tures in subsequent CMAP <set-surface-color-map > 
and <set-background-color > commands. The 
default is HLS. 


color-overlay-mode specifies the behavior of the 
terminal's writing surfaces. The factory default is 
OPAQUE. 


gGray-mocde specifies whether the terminal displays 
colors (COL) or black and white (BW). The default is 
COL. 


Color-speciiying-mode. The color-specifying-mode has 
four numeric parameters that determine the system to use. 
Table 6-3 lists the parameters and their meaning. 


In the HLS system, colors are specified by hue, lightness, 
and saturation coordinates as shown on the HLS color cone 
in Appendix G. 


The RGB system determines a color mixture by adding 
together different amounts of the additive primary colors 
(much like your television set). The system derives its name 
from the first letter of the three colors: red, green, and blue. 


The CMY system also derives its name from the three colors 


it uses: cyan, magenta, and yellow. This is very close to the 
printing process. 
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SETUP COMMANDS 
CMODE 


Color-overlay-mode. The color-overlay-mode parameter 
specifies how the writing surfaces act in relation to each 
other (see Table 6-3). 


@ The Opaque mode (Mode 1) sets all writing surfaces to 
opaque. The surface in front obscures all surfaces 
behind it. This is the factory default mode. 


@ In Subtractive mode (Mode 2), the terminal behaves like 
a light table in which the successive surfaces show 
through those on top. For subtractive mode to work prop- 
erly, the background color should be white or some other 
light color. 


@ Inthe Additive mode, colors drawn on one surface com- 
bine with colors on the surface in front of it. A red object 
on one surface, for instance, and a green object on 
another surface combine to produce a yellow color 
where the two surfaces overlap. 


Gray Mode. The gray-mode parameter determines whether 
the display will be in color or in black and white. If the 
parameter is 0 or omitted, the current gray mode setting is 
left unchanged. If the parameter is 1, the terminal is set to 
display colors. If the parameter is 2, the terminal is set to 
replace colors with gray levels, according to the transform: 


Gray level = (.30)*(Red level) + (.59)*(Green level) 
+ (.11)*(Blue level) 


The resulting gray level value is rounded to the nearest 
integer. 


The terminal always powers up in COL (color) mode. 
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Table 6-3 summarizes the CMODE parameters and their 
meanings. 


Table 6-3 
CMODE PARAMETERS 


Parameters Keywords and Their Meaning 


Color-specifying- 0 No Change 
mode 

RGB 

CMY 

HLS 


Machine RGB 


No Change 
Opaque 
Subtractive 
Additive 


No Change 

COL (color) 

BW 

(Black and White) 


Color-overlay-mode 


Gray-mode 


MO O/ WON OD/(HhWDND 


The following command sets the color specification to HLS, 
the color overlay to opaque, and the gray mode to color. 


CMODE 3 1 1 


For further information about the CMODE command, see 
the 4/10 Series Command Reference Manual. 
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SETUP COMMANDS 
CODE, COPY 


CODE COPY 


Selects which command set the terminal will recognize. Copies data from one device to another. 


CODE {ane | COPY source to destination 
ANSI | 
source specifies the source of the copy — that is, 


what data is to be copied. Valid sources are: 
HO: The host port. 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, device FO: 
is assumed. (Option 42 or 43) 


TEK sets the terminal to respond to Tektronix 4110- 


style commands. 


ANSI sets the terminal to respond to commands using 
ANSI X3.64 syntax. 


F1:filename A file on the flexible disk in drive 1. 
TEK mode allows the terminal to process Tektronix 41 10- (Option 43) 


style graphics and terminal control commands. 
msd:filename The msd: parameter is a mass-storage 


The ANSI setting is used to allow the terminal to process device address chosen from the list 
commands in the syntax described in ANSI Standard X3.64 SO — $7, 10 —T7, ..., Z0 — 27 (see 
(ISO Standard 6429). Some of the terminal’s commands are the Device Names discussion at the 
specified in these standards; other commands conform to beginning of this section). (Option 45, 


the syntax, but are specific to Tektronix’s implementation of 46, 47) 
this terminal’s firmware. 


One of the peripheral ports. 
(Option 10) 


Screen contents. (Option 09) 
The DMA interface (Option 3A) 


DMA pseudo devices (Option 3A) 


to is a keyword that indicates the direction of the 
COPY operation. 


destination specifies the destination of the copy — 
that is, where the data is to be copied. Valid destina- 
tions are: 


HO: The host port. 


[FO:]filename A file on the flexible disk in drive 0. If 
only filename is specified, device FO: 
is assumed. (Option 42 or 43) 


F1:filename A file on the flexible disk in drive 1. 
(Option 43) 
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COPY 


msd:filename The msd: parameter is a mass-storage 
device address chosen from the list 
SO — $7, TO —T7, ... ,Z0 — Z7 (see 
the Device Names discussion at the 
beginning of this section). (Option 45) 


One of the peripheral ports. 
(Option 10) 


HC: A color hard copy device. The back- 


[background] ground parameter must be either 0 or 
1: when it is O or omitted, a black 
screen background copies as white; 
when it is 1, a black screen back- 
ground copies as black. (Option 09) 


The DMA interface (Option 3A) 


DMA pseudo devices (Option 3A) 


NOTE 


File access on any device is restricted to files 
marked with the current usernumber (when rele- 
vant). That is, you can only copy a file marked with 
the current user number on the source device. 

When the file is copied to the destination device, 
the file is marked with the current user number. See 
the USERNUMBER command. 


The copy operation continues until: 

@ an end-of-file string is encountered (see EOFSTRING). 
® you press the CANCEL key. 

@ anerror is detected. 

An error can be caused by many things. For example, if the 
destination device is a disk drive, an error will occur if: 

@ there is no disk in the drive. 

@ the disk is write protected. 


@ the destination drive is trying to write onto a bad disk 
area. 


@ there isn’t enough room on the disk to hold the entire 
output file. 
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If a COPY is invoked in Setup mode and you enter anything 
from the terminal’s keyboard during the copy, the first 130 
characters are queued and executed when the COPY is 
finished. After you enter 130 characters, the bell rings each 
time you press any key (except CANCEL). 


Before you copy a file to a disk you should make sure that 
there is enough room for the file. You can determine the 
length of an individual file as well as the room available on 
the destination disk with the DIRECTORY command. 


You cannot copy to a file or disk that is write protected. A 
disk can be write protected by the WRITE PROTECT switch 
(see Section 2) or by uncovering the notch in the disk (see 
Section 3). A file can be write protected by the PROTECT 
setup command. 


If there is already a file on the destination disk with the file 
name you specify and it is not write-protected, the existing 
file will be replaced. If the existing file is write-protected, the 
copy fails and an error message is displayed. 


The following command copies data from a file called TEST- 
DATA.TMP on the flexible disk in drive 0 to a file called 
DATA23.DAT on the same disk: 


COPY TESTDATA.TMP to DATA23.DAT Cr 


The next command copies a file STUFF from the flexible 
disk in drive 1 to the output device attached to peripheral 
port 2: 


COPY F1:STUFF to P2: 


Copying to a 4691 Color Copier 


If you have Option 09, you can copy the contents of the pixel 
viewport directly to a 4691 color copier. To do this, specify 
“SC:" as the source and “HC:” as the destination. 


COPY SC: to HC:1 


Specifying a “1” after the “HC:” causes a black screen 
background to be copied as black; when the 1 is omitted 
after HC:, a black background copies as white. 


Because the COPY operation ties up all terminal functions, 
you may want to first copy the screen to a disk file and then 
spool the file to the copier. If you do this, then be sure that 
the same size media is in the copier when the file is 
SPOOLed. For example, this command copies the screen 
contents to a file called “ccopy” on the disk in drive 1: 


COPY SC: to F1:ccopy 
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When the terminal copies the screen contents, the file that 
is created (“Cccopy” in this example) contains information 
about the paper size currently in the color copier. When the 
SPOOL command: 


SPOOL F1:ccopy TO HC: 


is issued, the terminal checks that the color copier has the 
same size media in it as It did when the file was stored. If the 
a different size media is now in the copier, the terminal 
issues an error message. 


When you copy the screen contents to the disk file “ccopy’’, 
the file cannot be redisplayed (that is, LOADed). (Use SAVE 
to create a disk file that can be redisplayed.) 


Copying fo and From the Host 


lf the source device is the host (HO:), you must begin the 
data transmission before vou enter the COPY command 
from Setup mode. Once you enter the commana, ihe termi- 
nal will wait for a data stream from the host until an end-of- 
file string comes from the host or until the CANCEL key is 
pressed. 


One way to arrange the data stream is: 


O Type the command to the host to begin the data stream 
without the end-of-command character from outside of 
Setup mode. 


O Enter Setup mode. 


O Type in the COPY command with the desired 
destination. 


© Exit Setup mode (after you press the SET UP key, the 
light in the key stays on, but data is being transmitted to 
the host). 


© Type the end-of-command character. If your host echos 
the character typed on the terminal, the above results in 
the end-of-command character being the first character 
in the data stream. 


Another way to co this is: 


O Program the host so that there is a delay between the 
time you enter the end-of-command character for the 
host-data-send command and the time the data stream 
begins to flow. If you use this method you should give 
yourself enough delay time to enter Setup mode and 
type the COPY command with the desired destination. 
You may also want to use the QUEUESIZE command to 
create a large input queue. 


If you specify the host as destination, then be sure that the 


host is ready to accept data, or you may lose data and/or 
cause problems with the host. 
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SETUP COMMANDS 
COPY, CRLF 


CRLF 


Specifies whether a carriage return character is displayed 
as a carriage return or a carriage return + line feed. 
(Memory) 


CRLF yes 
ee 


yes is a keyword indicating that the terminal should 
attach a line feed character to each carriage return 
character. 


noe is a keyword indicating that the terminal should not 
attach a line feed charcter to the carriage return. This 
is the factory default. 


A carriage return moves the cursor back to the left margin of 
the current line; a line feed moves the cursor down one line 
from its current position. 


The following command causes the terminal to attach the 
line feed character to the carriage return: 


CRLF YES ©r 


If you set the parameter to “yes” and the host automatically 
sends a line feed character with the carriage return, the 
terminal “double spaces” each time you press the Rtn key 
because it is getting a line feed from the host and from the 
terminal. 


If the terminal is in Local mode, Rtn only returns the cursor 
to the left margin of the current line unless CRLF is set to 


im 3? 


yes. 
When the terminal is in Setup mode, pressing Rtn always 


gives the carriage return + line feed combination, regard- 
less of the CRLF setting. 
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DA2INDEX, DABUFFER 


DA2INDEX 


Sets the alternate color index for dialog text. 
(Memory) 


DA2INDEX index 


index is a valid color index. The range for index is 
from 0 through 32767; however, any value greater 
than the maximum index for the terminal is set to this 
maximum. If N is the number of bit planes installed in 
the terminal, then the maximum color index for the 
terminal is 2-1. 


This command selects the color index that will be used to 
display characters in the character set determined by the 
ANSI command Select-Graphic-Rendition. (See the 47/0 


Series Command Reference Manual for details on this com- 


mand.) The alternate color index set with DA2INDEX is 
effective after Select-Graphic-Rendition is set to 1 and the 
dialog area is made visible. 


The color index is interpreted in terms of the color map from 


the current graphics surface. See the discussion of the 
DASURFACE command. 
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DABUFFER 


Specifies the size of the dialog buffer. 
(Memory) 


DABUFFER lines 


lines is an integer parameter that specifies the num- 


ber of lines in the dialog buffer. The minimum dialog 
buffer size is two; the factory default is 34. 


A change in the dialog’s buffer size becomes effective the 
next time the dialog area becomes visible. 


The maximum dialog buffer depends on the amount of 
available memory. If you specify a dialog buffer larger than 
the available memory, it is set to the available memory. 


lf the buffer is full when a line of text is received, the first line 
is deleted to make room for the new line. 


The following command sets the dialog buffer size to hold 
30 lines of data: 


DABUFFER 30 °rR 


If you change the size of the dialog buffer, the information in 
the dialog area is not lost or changed unless the size is 
reduced. In that case, the most recent dialog text is 
retained. The new size takes effect the next time the dialog 
area becomes visible. | 


If you try to make the dialog buffer smaller than the dialog 


area, an error is detected and the buffer is set to the number 
of visible lines in the dialog area. 
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DACHARS 


Specifies the maximum number of characters per line in the 
dialog buffer. 
(Memory) 


DACHARS width 


width is an integer parameter indicating the maxi- 


mum number of characters per line. The factory 
default is 80. The minimum is 5; the maximum Is 80. 


If you specify more than 80 characters per line, the terminal 
sets the width to 80 characters. 


lf you specify more characters than what will fit (due to the 
current dialog area position), then the dialog area position 
changes to accommodate the specified width when you 
toggle the dialog key. The following warning is displayed 
the next time the dialog area is visible (you will not see the 
warning if the error reporting mechanism is set to Suppress 
warnings): 


>> Terminal issues Message LVO3: 
>> Dialog Parameters Modified 


The terminal remembers the width you specified and if the 
dialog area position is changed, the width parameter is 
automatically changed accordingly. (See the DAPOSITION 
command description.) 


lf you change the width, information in the dialog area is not 
lost. The new width takes effect the next time the dialog 
area Is visible, and when the next text is received in the 
dialog area. 


The following command changes the maximum width of 
each line in the dialog area to 35: 


DACHARS 35 ©r 
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DACHARS, DAENABLE 


DAENABLE 


Enables or disables the dialog area. 
(Memory) 


DAENABLE eet 
no 


yes is a keyword parameter which enables the dialog 
area. If you do not specify ‘“‘yes” or “no,” the parame- 
ter is set to “yes.” 


no is a keyword parameter which disables the dialog 
area. This is the factory default. 


When the dialog area is enabled, all alpha (non-graphics) 
text is directed to it. The dialog area is made visible or invisi- 
ble by a separate command (see the DIALOG key in Section 
2 or the DAVIS command in this section). If the dialog area is 
enabled when you turn the terminal on, the dialog area will 
automatically be visible. 


When the dialog area is disabled, alpha text is directed to 
the graphics area of the screen. If the dialog area is visible 
but not enabled, you can see text written in the dialog area 
before it was disabled, but the subsequent text will not go 
into the dialog area. 


When the dialog area is enabled, pressing the Rtn key does 
not cause the terminal to exit from Vector, Marker, or 4010- 
style GIN mode. If you are in one of those modes at the end 
of a program, press the CANCEL key to return the terminal 
to Alpha mode. 


The following command enables the dialog are: 


DAENABLE Cr 
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DAINDEX 


Specifies color indices in the dialog area. 
(Memory) 


DAINDEX character, background 


character is an integer parameter specifying the color 
index of text in the dialog area. The factory default for 
the character parameter is 1 (white). 


background is an integer parameter specifying the 
color index of the background of the character cell in 
which the character is drawn. The factory default is 0 
(transparent). 


The range for both character and background is from 
0 through 32767. The actual number of distinct color 
indices in the terminal depends on the number of bit 
planes installed. If N is the number of bit planes, the 
maximum index number is 2N—1. If you specify a color 
index larger than this maximum, it is set to the 
maximum. 


With the standard four bit planes, color indices range from 0 
to 15. With six bit planes, color indices range from 0 to 63. 
With eight bit planes, color indices range from 0 to 255. 


NOTE 


Other 4110 Series terminals may process a third 
parameter (called a wipe index) in this command. 
For compatibility, this terminal accepts the third 
parameter, but ignores it. 


When you change a dialog area index, it is effective the next 
time the dialog area is made visible. Characters already in 
the dialog area are not affected. 


Note that if you set both indices to 0, the dialog area would 
be invisible because you would have transparent characters 
and transparent character cells on a transparent back- 
ground. Text in the dialog area would also be invisible if you 
set both indices the same since you would have the same 
color characters and character cells on the same color 
background. 
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DALINES 


Specifies the number of lines of the dialog buffer displayed 
on the screen. 
(Memory) 


DALINES lines 


lines is an integer parameter, specifying the number 


of lines in the dialog buffer which are to be visible. The 
factory default is five. The valid range is from 2 to 64. 


If you specify more visible lines than the current dialog area 
position allows, the terminal automatically changes the 
position to allow the specified number of lines. In that case 
the following warning is displayed the next time the dialog 
area becomes visible (you will not see the warning if the 
terminal’s error reporting mechanism is set to suppress 
warnings): 


>> Terminal lssues Message LVO3: 
>> Dialog Parameters Modified 


If you change the number of visible lines, the information in 
the dialog buffer is not changed or lost. The change is effec- 
tive the next time the dialog area is made visible (see 
DAVIS). 


If you set the dialog area larger than the dialog buffer, the 
buffer size is automatically increased to match the dialog 
area size. If there is not enough terminal memory available 
to do this, both the dialog area and the dialog buffer are set 
to the maximum size allowed by the available memory. 


The following command causes 15 lines of the dialog buffer 
to be displayed at a time: 


DALINES 15 rR 
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Specifies the writing mode for the dialog area. 
(Memory) 


DAMODE iepaiee 
overstrike 


replace is a keyword that specifies Replace mode. In 
Replace mode, when a character Is displayed it 
replaces any character previously shown there; the 
old character is erased. In addition, when you press 
the current charde/ key in Setup mode, the character 
to the left of the cursor is erased when the cursor 
backs up to that character position. 


oversirike is a keyword that specifies Overstrike 
mode. In Overstrike mode, a Space or Underscore 
cnaracter does not replace a character already dis- 
played; the old character is still displayed. The Space 
bar just moves the cursor over the character without 
erasing it; the Underscore key will underline the char- 
acter. (All other keys replace the old character, just as 
they do in Replace mode.) The current charde/ key 
backspaces the cursor over the previous character, 
but does not erase it. 


NOTE 


The new DAMODE setting does not become effec- 
tive until the dialog area becomes visible. If the 
dialog area ts already displayed, toggle (press twice) 
the DIALOG key to see the effects of the new 
setting. 
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SETUP COMMANDS 
DAMODE, DAPOSITION 


DAPOSITION 
Specifies the location of the lower-left corner of the dialog 


area. 
(Memory) 


DAPOSITION x, y 


x 1S an integer parameter specifying the X-axis coordi- 
nate of the lower-left corner of the dialog area. The 
range for this parameter is from 0 through 4095. 


y is an integer parameter specifying the Y-axis coordi- 
nate of the lower-left corner of the dialog area. The 
range for this parameter is from 0 through 4095. 


oc y% 


An error results if you enter “x” or “y’’ coordinates that are 
not within the given ranges. The position is automatically 
adjusted if the current DACHARS and DALINES settings 
would not fit in the specified position. The terminal remem- 
bers the specified location and if the line width or number of 
visible lines is changed, the location of the dialog area is 
changed appropriately. 


Note also that a y parameter greater than 3276 would place 
the dialog area above the top of the screen (Figure 6-3). 


4095 ,3276 


4095,0 
he 


4665-36 


Figure 6-3. Limits for DAPOSITION. 
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If the dialog area position is modified, the following warning 
is displayed the next time the dialog area becomes visible 
(you will not see the warning if the terminal’s error reporting 
mechanism is set to suppress warnings): 


>> Terminal Issues Message LV03: 
>> Dialog Parameters Modified. 


If you change the position of the dialog area, information 
already in the dialog area is not lost. It appears at its new 
position the next time the dialog area is made visible 
(see DAVIS). 


The following command moves the lower-left corner of the 
dialog area near the center of the screen (if DACHARS is 
set to 40 or more or if DALINES is set to 17 or more, the 
terminal adjusts the actual position): 


DAPOSITION 2049, 1561°R 
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DASURFACE 


Specifies the surface whose current color map will be used 
for displaying dialog text. 
(Memory) 


DASURFACE surface-number 


surface-number is an integer that specifies a graphic 
surface in the terminal. Valid values of surface-num- 
ber are -1 and from 1 through 8, inclusive. The effec- 


tive maximum value, however, depends on the 
number of bit planes installed in the terminal. The 
factory default for DASURFACE is 1 (the front-most 
surface). 


This command selects the graphic surface whose color 
map will be used when the dialog colors are set with the 
DAINDEX or DA2INDEX commands. Since the dialog area 
is a separate surface from the graphic surfaces, this com- 
mand in effect sets the color map for the dialog “surface” to 
the color map of one of the graphic surfaces. This command 
will be used in conjunction with the DAINDEX and DA@2IN- 
DEX commands, which set the actual color indices 
assigned to text and character background. 


For example, consider the following two commands: 


DASURFACE 2 
DAINDEX 3 6 
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The DASURFACE 2 command instructs the terminal to use 
the color map defined for graphic surface 2 when displaying 
dialog colors. The DAINDEX 3 6 command sets the dialog 
text color to color 3 and the character background color to 
color 6, as these color indices are defined for graphic 

surface 2. 


The effective maximum surface-number is determined by 
the number of bit planes installed in the terminal. If a sur- 
face-number greater than the maximum is specified, the 
Surface-number is set to the maximum for the terminal. 


Before DASURFACE is effective, surfaces must be defined 
for the terminal by the < set-surface-definition > command 
(see the 4//0 Series Command Reference Manual). \t 
surfaces are not defined, DASURFACE causes an error 
message. 


NOTE 


The action of this command in some other 4110 
Series terminals is slightly different. In those termi- 
nals, DASURFACE actually instructs the terminal 
to display dialog text on the specified graphic sur- 
face. The resulting visual effect, however, is similar. 
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DASURFACE, DAVIS 


DAVIS 


Specifies whether or not the dialog area is visible. 
(Memory) 


DAVIS ee 
no 


yes is a keyword specifying that the dialog area 
should be visible. This is the power up and reset 
default if the dialog area is enabled. If you do not 


enter “yes” or “no,” the terminal defaults to “yes.” 


no is a keyword specifying that the dialog area should 
not be visible. This is the power up and reset default if 
the dialog area is not enabled. 


Entering this command has the same effect as pressing the 
DIALOG key. DAVIS yes makes the dialog area visible and 
turns the light in the DIALOG key on. DAVIS no makes the 
dialog area invisible and turns the light in the key off. This 
command takes effect immediately 


If the dialog area is enabled when the terminal is turned on, 
the dialog area is automatically visible. 


You can use the DAVIS command to update the dialog area 
if you change any of its attributes. For example, if you 
change the dialog area’s position and the number of visible 
lines, enter the following command to make the changes 
effective: 


DAVIS rR 


Even though the dialog area may already be visible, this 
command updates it as though the dialog area were turned 
off and back on again. (You can also toggle the DIALOG key 
to update the dialog area display.) 
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DEFINE 


DEFINE 


Defines a macro and associates it with a key or an integer. 


DEFINE [macro-identifier] 
[all] 


DEFINE key, °Lmacro™. 


DEFINE key, °.Lmacro [*e macro “e] ° 


macro-identifier specifies the key or integer with 
which this macro is to be associated. If the command 
is terminated after this parameter, the macro associ- 
ated with the specified key or integer is deleted. 


all is a keyword indicating that all existing macros 
should be deleted. 


D_ is the delimiter character. You can use any ASCIl 
character to delimit the macro except: 


acomma 
a space 

the ‘character delete” character (see 
EDITCHARS) 

the “line delete” character (see EDITCHARS) 
the “literal” character (see EDITCHARS) 


The first character after the “key” parameter that is 


not a space, comma, or edit character is taken as the 
delimiter for that macro. The delimiter should not 
occur in the macro itself, since the second use of the 
delimiter terminates the macro. 


macro is the character or character string generated 
when you press the specified key or when the host 
executes the macro. The total length of the DEFINE 
command (including the command word and macro) 
can be a maximum of 130 characters. If you want to 
include a “carriage return” or one of the edit charac- 
ters in the macro, it must be preceded by the “literal” 
character — see the EDITCHARS command. 


KE is the ‘‘key execute delimiter” character. When this 
character appears in a macro, it changes the direction 
of the macro expansion. If the macro was directed to 
the host, the key execute delimiter causes it instead 

to be directed to the terminal; if the terminal had been 
receiving the macro it is subsequently sent to the 

host. The expansion of a subsequent macro starts in 
the same direction as when the last macro ended. The 
“key execute delimiter” is defined by the KEYEXCHAR 
command. 


6-30 


Specifying a Key or Integer 


Indicate an alphanumeric key you want to associate with a 
macro by pressing the key or by entering its ADE value. 


For example, the following commands both assign a macro 
to the uppercase A. After this command, whenever you 
press the uppercase A, the character sequence “a macro or 
string” would be transmitted. 


DEFINE A /amacroorstring/ Cr 
DEFINE 65 /amacroorstring/ Cr 


Each function key can be identified by a mnemonic abbrevi- 
ation or by an integer as in Table 6-4. 


Table 6-4 
FUNCTION KEY IDENTIFIERS 


F4 function key 1 
F2 function key 2 
F3 function key 3 
F4 function key 4 
F5 function key 5 
F6 function key 6 
F7 function key 7 
F8 function key 8 
S1 shifted function key 1 
$2 shifted function key 2 
S3 shifted function key 3 
S4 shifted function key 4 
35 shifted function key 5 
S6 shifted function key 6 
S7 shifted function key 7 
$8 shifted function key 8 


The following commands show the two ways to assign “a 
macro or string” to function key 1. 


DEFINE F1 /amacroorstring/ °r 
DEFINE 128 /amacroorstring/ °rR 
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Associating a Macro With an Integer 


You can assign an integer value for the “key” to cause the 
macro to be associated with the specified integer. One valid 
range of integers is 144 to 34767. A macro associated with 
an integer in this range can only be executed by a command 
from the host (or by using a special form of commands 
called “escape sequences’’). 


Another group of macros, byte macros, are identified by 
integers in these ranges: 


O —32768 to ~32742 
O ~32740 to ~32737 
Oo —32608 to -32513 


These macros are executed wnen the host sends a charac- 
ter that matches the identifying integer. To match a charac- 
ter to an integer, subtract 32768 from the character’s ASCII 
decimal equivalent. For example, if you define a macro 
identified by -32743, when the host sends the —m character, 
this macro is executed, since the decimal equivalent of —m is 
25 (25-32768 = —32743). Usually byte macros are defined 
by a host or local program instead of the operator. 


The following command shows how to associate ‘‘a macro 
or string” with the integer 1000: 


DEFINE 1000 /amacroorstring/ Cr 


Carriage Return and Edit Characters 


Since the carriage return control character is executed In 
Setup mode when you press the Rtn key, it must be treated 
specially to be part of amacro. The same is true for the keys 
reserved as edit characters (see EDITCHARS). 


The third character defined by EDITCHARS is the “‘literal”’ 


character. To include a carriage return or edit character ina 
macro, precede it by the literal character. 
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SETUP COMMANDS 
DEFINE 


For example, the following command programs the F2 key 
to disable the dialog area: 


DEFINE F2 /DAENABLE no~n/ £r 


The ‘ ~”’ before the first °r is the literal character (factory 
default). It causes the first “rR to be displayed and included in 
the macro definition, rather than being executed immedi- 
ately. Another example is: 


DEFINE F4 /COPYHO: TOFO0O: HOST.DATA~£nr/ Cr 


Using the Kev Execute Delimiter 


When a macro is expanded by pressing a key, every time 
the terminal encounters the key execute delimiter it 
reverses the direction of the macro expansion. (When a 
macro is expanded with the escape command “Expand- 
Macro,” the terminal ignores the key execute delimiter 
character. The key execute delimiter character is also 
ignored when the terminal is in Setup mode.) 


This command: 


DEFINE 128 /FORT GRAF ~ ©r Ke co SO1 Ke EX 
GRAF ~ Cr/ Cr 


defines a macro for function key f1. When the terminal is not 
in Setup mode and function key f1 is pressed, the macro 
Starts to expand to the host. (The initial direction is always 
towards the host.) When the host encounters the first key 
execute delimiter, the direction of the macro expansion 
changes and the macro is expanded to the terminal. The 
second key execute delimiter directs the flow back to the 
host. 
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DELETE (Option 42, 43, 45, 46, 47) 


Deletes the specified file. 


DELETE [device] filename 


device specifies the disk device from which you want 
to delete a file (see the Device Names list at the begin- 
ning of this section). If no device is specified, drive FO: 


is assumed. 


filename is an undelimited character string identifying 
the name of the file to be deleted. 


An error results if the disk is write-protected (by the WRITE 
PROTECT switch or the write-protect notch in the disk) or if 
the file you try to delete is write-protected by the PROTECT 
setup command. 


The following command would delete the file named “info” 
from the disk in drive 0: 


DIRECTORY (Option 42, 43, 45, 46, 47) 


Displays or copies directory information for a disk or file. 


DIRECTORY [source] [to destination] 


source specifies the device or file for which a direc- 
tory listing is to be generated. Valid sources are: 


FO: The flexible disk in drive 0. If no source 
parameter is specified, FO: is 
assumed. 

Ft: The flexible disk in drive 1. 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, disk drive 
FO: is assumed. (Option 42 or 43) 


A file on the flexible disk in drive 1. 
(Option 43) 


F1:filename 


msd:[filename] The msd: parameter is a mass- 
storage device address chosen from 
the list SO— S7, TO—T7,..., 


DELETE info Z0 — Z7 (see the Device Names dis- 
cussion at the beginning of this sec- 
tion). If only the msd: parameter is 
specified, a directory for the entire 
storage device is generated. (Option 
45) 

to is a keyword that indicates the direction in which 

information is to be copied. 

destination specifies where the directory is to be 

written. Valid destinations are: 

none specified The terminal screen. 

HO: The host port. 

[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, device FO: 
is assumed. (Option 42 or 48) 

Fi:filename A file on the flexible disk in drive 1. 
(Option 43) 
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PO: 
Pt: 
P2: 


Directory access on any device ts restricted to files 
marked with the current user number. Therefore, 
the DIRECTORY command only displays those 
files marked with the current user number on the 
given source device. (However, free space informa- 
tion refers to the entire disk; see Figure 6-4). Also, 
if the destination device accepts user numbers, the 
file that the directory is written into is marked with 
the current user number. 


msd:filename The sd: parameter is a mass-storage 
device address chosen from the list 
SO — S7, TO—T7,... , ZO — 27 (see 
the Device Naies discussion at the 
beginning of this section). (Option 45) 


One of the peripheral ports. 


lf no parameters are specified, the directory of the 
flexible disk in drive O is wriiten to the terminal screen. 


The following command displays the directory for the entire 


disk in drive 0 (Figure 6-4A): 
DIRECTORY Cr 


The following command displays the directory of a file 
named “practice.exe’’ on the disk in drive O (Figure 6-4B): 


DIRECTORY practice.exe 


If you specify the host as the destination for the directory, 


then be sure that the host is ready to accept data. If you do 


not, you may lose data and cause communications prob- 


lems with the host. 
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DIRECTORY 

DRIVE FO: USER NUMBER 1e 

-~NAME PROTECT 
PRACTICE EXE YES 
HAVE A NO 
GOOD DAY NO 
NEWDATA DAT NO 
INITIAL CMD YES 

~ENTRIES USED: 36 

~ENTRIES FREE: 284 

~BLOCKS USED: 90 

-~BLOCKS FREE: 218 

~BLOCK SIZE: 2048 

A 

DRIVE FO: USER NUMBER Je 

-NAME BLOCKS PROTECT 
PRACTICE EXE 32 NO 

-ENTRIES USED: 6 

-~ENTRIES FREE: 3714 

-BLOCKS USED: 32 

-~BLOCKS FREE: 276 

-BLOCK SIZE: 2048 

B 4665-27 


Figure 6-4. Sample Directories. 
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DISMOUNT (Option 42, 43, 45) 


Tells the terminal that a disk has been replaced. 


DISMOUNT device 


device is a device name, as specified in the Device 
Names discussion at the beginning of this section. 


This command tells the terminal that a disk has been 
replaced in the specified device. The terminal then scans 
the new disk to determine data allocation and block informa- 
tion. DISMOUNT should always be used before accessing a 
replaced storage medium. 


NOTE 


If you change floppy disks and do not use 
DISMOUNT before you do a DIRECTORY ora 
read operation, then the entry and block informa- 
tion for that disk may be inaccurate. 
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DUPLEX (Option 01) 
Specifies what kind of Duplex mode the terminal is in. 
(Memory) 


full 
normal 
arts 
super 


DUPLEX 


full specifies that the terminal is in Full Duplex. This ts 
the factory default communications mode for a termi- 
nal with Option 01 installed. If you enter the command 
word and no parameters, the terminal defaults to 
“full.” 


normal specifies that the terminal is to be in Half 
Duplex Normal mode. 


arts puts the terminal into Half Duplex with Automatic 
Request to Send mode. 


super puts the terminal into Half Duplex with Supervi- 
sor mode. 


Section 5 of this manual provides a brief overview of the 
terminal’s communications modes. See the 47/0 Series 
Host Programmers Manual for further information. 
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ECEIO 


Specifies whether or not the terminal provides an “echo” of 
characters typed on the keyboard and sent to the host 
computer. 

(Memory) 


ECHO 
no 


yes is a keyword meaning that the ierminal will pro- 
vide the echo. If you enter the command word but do 


not specify “yes” or ‘‘no,” the terminal defaults to 


6 


yes.’ 


no is a keyword meaning that the terminal will not 
provide the echo. This is the factory default. 


The term “echo” refers to how characters are displayed on 
the terminal screen as they are typed at the keyboard. 


lf ihe computer you log onto is a remote-echo host, it pro- 
vides the echo for you automatically. If you set the terminal 
to provide the echo too, each character is echoed twice 
when you are in communications with the host — once by 
the terminal and once by the host. 


If the computer you log onto is not a remote-echo host, enter 
the following command so the terminal will provide the echo 
when you are communicating with the host: 


ECHO yes ©r 


When the terminal is in Setup or Local modes, the echo is 
provided by the terminal regardless of the status of ECHO. 


4115B OPERATORS 


REV, JAN 1984 


SETUP COMMANDS 
ECHO, EDITCHARS 


EDITCHARS 


Specifies ‘‘delete” characters for Setup mode and a “‘lit- 
eral” character to precede control characters in macros. 
(Memory) 


EDITCHARS chardel, linedel, literal 


chardel can be any ASCII character except the “‘line- 
del” or “literal” characters. Specify a character by 
pressing the appropriate key or entering its ADE 
(ASCII Decimal Equivalent) value. The ‘“‘chardel”’ 
character is used in Setup mode to backspace along 
a line to correct a typing error. The factory default is 
Delete (ADE 127) — the Rub Out key. 


linedel can be any ASCII except the “chardel” or 
“literal” characters. Specify a character by pressing 
the appropriate key or entering its ADE value. The 
‘linedel” character is used in Setup mode to cancel a 
line without executing it, and start a new line. The 


factory default is Cancel (ADE 24). Type the Cancel 
character from the keyboard by pressing the Ctrl and 
X keys at the same time. 


literal can be any ASCII character except the “char- 
del” or “linedel”’ characters. Specify a character by 
pressing the appropriate key or entering its ADE 
value. The factory default literal character is the 
“tilde” (~) (ADE 126). The “‘literal” character must 
precede the following characters if they are included 
ina macro: 


a Carriage return 
the character delete 
the line delete 

the literal character 
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The following command specifies the “chardel,” “‘linedel,”’ 
and “‘literal’’ characters as the percent sign (%), pound sign 
(#), and dollar sign ($), respectively. 


EDITCHARS % # $ &r 


If the dialog area is not used, the terminal will always over- 
write characters when you use the “‘chardel” key — it will 
not replace the characters. If the dialog area is not used, the 
“linedel” key moves down to the next line instead of to the 
beginning of the current line. 


A sample of how to use the literal character is included in 
the DEFINE command description. 


You don’t have to enter all three parameters if you only want 
to change the first or second edit characters. For example, if 
you only want to change the “character delete” character, 
you could enter the following command: 


EDITCHARS & rR 


That command changes the character delete character to 
ampersand (&) and leaves the line delete and literal charac- 
ters unchanged. 
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EOFSTRING 


Specifies the end-of-file string during SPOOL, COPY, and 
PCOPY operations. This string is used to mark the end of a 
file. During transmission to the host, when the terminal 
reaches the end of a file, it appends this string to the trans- 
mission. When this string is sent from the host, it signals the 
terminal that the end of the file has been reached. 

(Memory) 


EOFSTRING “:string®?t 


DL is the delimiter character. This character must 
precede and follow the end-of-file string. The first 
character after the command word that is not a 
comma, space or edit character (see EDITCHARS) is 
the delimiter character for this command. 


string is a sequence of up to ten ASCII characters. 
The first character cannot be repeated in the string. If 
you enter just the command word and no string, the 
terminal defaults to the null string. 


When the terminal is copying a file from the host, it termi- 
nates the copy when it encounters the end-of-file string. 


The end-of-file string should be set to whatever the host 
computer actually sends at the end of a file. If it is not, you 
will have to press the CANCEL key to close disk files. 


In the following command, the slash (/) is the delimiter and 
the end-of-file string is set to an ampersand (&). 
EOFSTRING /&/ Cr 


This parameter may be set by an application program on 
the host computer or by an initialization file on a disk. If itis 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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EOLSTRING 


Assigns the end-of-line string used by the terminal. 
(Memory) 


EOLSTRING string? 


Di is the delimiter character. The same character must 
precede and follow the end-of-line string. The first 
character after the command word that is nota 
comma, space, or edit character (see EDITCHARS) is 
the delimiter character for this command. 


string is the character string the terminal uses to 
signal the end of the transmission of a line of data. 
The factory default is carriage return. 


The end-of-line string is sent by the terminal at the end of (or 
during) transmissions generated by the terminal. 


When a host requests information from the terminal, the 
terminal may send it automatically, not requiring operator 
interaction. For example, the program may request a report 
of error messages or some graphics input data. In such 
cases, the terminal sends an end-of-line character to the 
host to indicate the end of its transmission. 


The following command changes the end-of-line string to 
the 'r (line feed): 


EOLSTRING ‘'r’ Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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EOLSTRING, EOMCHARS 


EOMCHARS 


Specifies the end-of-message (turnaround) characters. 
(Memory) 


EONMCHARS [char1] 
[char1, char2] 


char1 and char2 are undelimited ASCII characters. If 
you specify just one character, the second character 


is set to null. If you do not specify either character, 
both are set to null and no end-of-message checking 
is done at all. The default end-of-message characters 
are ©r (carriage return) and ‘+ (line feed). 


lf the terminal is in Prompt mode, Block mode or Half 
Duplex mode, it stops transmitting when it encounters 
either end-of-message character. (See the PROMPTMODE, 
BLOCKMODE, and DUPLEX commands.) 


In Prompt mode, for example, when an end-of-message 
character is transmitted, the terminal stops transmitting 
until it receives a prompt string. 


The following command sets the end-of-message charac- 
ters to ‘r (line feed) and Fc (escape). 


EOMCHARS ‘Fr £c pr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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ERRORLEVEL 


Specifies how severe an error must be before it is displayed 


by the terminal. 


ERROR LEVEL 


0 specifies that all messages, warnings, errors, and 
terminal failure messages should be displayed. If you 
enter just the command word and no parameter, the 
error level is set to 0. 


1 specifies that warnings, errors and terminal failure 
messages should be displayed. 


2 specifies that errors and terminal failure messages 
should be displayed. This is the default. 


3 specifies that only terminal failure messages should 
be displayed. 


4 suppresses all messages, warnings, errors, and 
terminal failure messages. 


The ERRORLEVEL command does not affect error mes- 
sages that are generated by host resident software pro- 
grams or the host computer. 


The terminal's error messages are stored in an error queue 
whether or not they are displayed. The application program 
can examine that queue for an error report. 


The following command would set the terminal so that only 
terminal failure messages are displayed: 


ERRORLEVEL 3 Cr 


Appendix A lists the terminal’s warnings, error messages 
and terminal failure messages related to setup commands 
discussed in this section. 
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FIXUP 


Specifies when and how thoroughly a viewport is updated. 


FIXUP level 


level is an integer parameter with a value of 0, 2, 4 or 
6. Each value specifies when the viewport is updated. 


0 the screen is updated when you press the Page 
key or VIEW key. 


2 the actions for fixup level 0 are taken and the 
display is also updated as changes are made to 


the current view. 


4 the actions for levels 0 and 2 are taken and the 
current viewport is updated when a segment oper- 
ation in XOR mode is performed. 


6 the actions for levels 0, 2 and 4 are taken and 
segments are immediately erased from the view- 
port if they are deleted or made invisible. This is 
the factory default. 


The higher the value of the “level” parameter, the more the 
current view is updated as it is changed. 


If you enter just the command word with no parameter, the 
level is set to 0. 


A positive fixup level other than 0, 2, 4, or 6 has the same 
effect as the next lower fixup level; for example, fixup level 3 
has the same effect as fixup level 2. A negative fixup level 
sets the fixup level to 0 and causes the terminal to issue a 
warning. 


Regardless of the fixup level, the current view is always 
completely updated when you press the Page key; the spec- 
ified view is updated whenever you issue the RENEW setup 
command. 
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FLAGGING 


Specifies whether or not the terminal is to use flagging, and 
if so, what kind of flagging. 
(Memory) 


none 
input 
output 
in/out 
DTR/CTS 


FLAGGING 


none is a keyword indicating that flagging is not to be 
done. This is the factory default. 


input is a keyword indicating that when the terminal’s 
input buffer is full, the terminal sends a DC3 character 
to stop the host; it sends a DC1 character when it is 
ready to receive data again. 


output is a keyword indicating that the DC1 and DC3 
characters are used for flagging. 


in/out is a Keyword indicating that the terminal and 
host both use the DC1 and DC3 characters to flag 
each other as to when to start and halt communications. 


DTR/CTS is a keyword indicating that when the termi- 
nal’s input queue is nearly full it lowers the DTR (DATA 
TERMINAL READY) line on the RS-232 connector; 
when the terminal’s input queue is ready for more 
data, the terminal raises the line. 


For output, when the host lowers the CTS (CLEAR TO 
SEND) line, the terminal stops sending data; the 
terminal resumes transmission when CTS goes high 
again. 


Flagging allows the terminal and host computer to indicate 
to each other when they are ready to send or receive data. 
This prevents their input buffers from overflowing, which 
would cause data to be lost. 


The following command causes the terminal to use input 
flagging: 
FLAGGING input Cr 


Whether or not the terminal should use flagging, and what 
kind, depends on your host computer. 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
FLAGGING, FORMAT 


FORWAT (Option 42, 43, 45, 46, 47) 


Initializes a disk for use. 


FORMAT device[/C][/track]... 


device is a disk device name. Valid disk device names 
are: 


FO: The flexible disk in drive 0. (Option 42/43) 
ei The flexible disk in drive 1. (Option 43) 
msd: The msd: parameter is a mass storage 


device from the list SO-—~S7, TO-—T7,... 
ZO —- Z7 (see Device Names at the begin- 
ning of this section. (Option 45/46/47) 


FORMAT creates a predetermined number of 
directory entries on the disk according to the 
device name entered. 


/C is an optional parameter used to format a 4926 
or Option 46/47 10-megabyte hard disk to make 
the disk compatible with Local Programmability. 


/track identifies known bad tracks on a 4926 or 
Option 46/47 hard disk. You can specify up to five 
bad tracks, from /1 to /65535. 


WARNING | 


Formatting a disk destroys all information cur- 
rently on the disk. Format only new disks or disks 
whose contents you do not want to keep. 


Do not open the door of a flexible disk drive while 
a disk is being formatted. If you do, you must close 
the door, press RESET, and reformat the disk. 


A new disk must be formatted before it is accessed for the 
first time. FORMAT creates a predetermined number of 
directory entries on the disk, depending on the type of disk: 


Option 42, 43 (8” flexible disks) 320 entries 
4925 Dual Flexible Disk Drive 64 entries 
(514” flexible disks) 

4926 Hard Disk Drive 2048 entries 


or Option 46/47 Hard Disk Drive 


/C is an optional parameter that is used when you are for- 
matting a 4926 or Option 46/47 hard disk for compatibility 
with Local Programmability. The /C argument formats the 
hard disk and limits the disk space to 8 megabytes, which is 
required for compatibility. With the optional /track argu- 
ment, you can then identify up to five known bad tracks on 
the hard disk. 
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SETUP COMMANDS 
GAMODE, GINAREA 


GAMODE GINAREA 
Specifies background for alpha text in the graphics area. Maps a specified rectangular region on a graphics input 
(Memory) (GIN) device onto a specified rectangular window in termi- 


nal coordinate space. 


GAMODE i sans 
overstrike GINAREA device-function, window-type, 


first-corner, Second-corner 


replace specifies that only the character itself is dis- 
played; the rest of the character cell is not displayed. 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


This is the factory default. 


overstrike specifies that the character cell is dis- 
played at the same gray level as the current back- 
ground gray-level (see DAINDEX). 


thumbwheels for locator function 
thumbwheels for pick function 
tablet for locator function 
tablet for pick function 

10 tablet for stroke function 

24 port 0 for locator function 

25 port 0 for pick function 

32 port 1 for locator function 

33 port 1 for pick function 

40 _ port 2 for locator function 

41 port 2 for pick function 


This command is similar to DAMODE except that it affects 
the display of alpha text in the graphics area instead of the 
dialog area. 


If you enter just the command word and no parameter, the 
parameter is set to overstrike. 


window-type specifies the window type: 


-1 the window set by the GINWINDOW 
‘command 


0 the window of the current view 


1 to 64 the window of view 1 to 64, respectively 


first-corner specifies the x and y coordinates of the 
first corner of the area that you are identifying on the 
specified GIN device. The valid range for both coordi- 
nates Is 0 to 4095. 


second-corner specifies the coordinates of the sec- 
ond corner of the area that you are identifying on the 
specified GIN device. The valid range for both coordi- 
nates is 0 to 4095. 


This command assumes that the GIN device is 4096 x 
4096 units square. If the device is rectangular (not square), 
the command assigns 4096 units to the long axis of the 
device, and a proportional number of units to the short axis. 


If you specify the same value for the two x-coordinates or for 
the two y-coordinates (if the GIN area is zero in either direc- 
tion) then an error is generated, except when you specify 
both corners to be (0,0). In this case, the GIN area defaults 
to from (0,0) to (4095,4095). | 
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GINCURSOR 


Specifies which segment will be used as the graphics cur- 
sor for all subsequent GIN operations. 


GINCURSOR  device-function, Sseqment-number 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


thumbwheels for locator function 
thumbwheels for pick function 
tablet for locator function 
tablet for pick function 

tablet for stroke function 

port O for locator function 

port O for pick function 

port 1 for locator function 
port 1 for pick function 

port 2 for locator function 

port 2 for pick function 


segment-number is the number of the segment to be 
used as a graphic cursor. Segment 0 is the crosshair 
cursor. The valid range is 0 to 32767. 


No action is seen when this command is given; the result 
will be seen later when a GINENABLE command is issued 
for the specified device-function combination. 


When a segment is used as the GIN cursor, the segment’s 
position is the point reported when a GIN event occurs. 


SETUP COMMANDS 
GINCURSOR, GINDISABLE 


GINDISABLE 


Disables the specified graphic input (GIN) combination. 


GINDISABLE device-function 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


thumbwheels for locator function 
thumbwheels for pick function 
tablet for locator function 
tablet for pick function 

tablet for stroke function 

port O for locator function 

port O for pick function 

port 1 for locator function 

port 1 for pick function 

port 2 for locator function 

port 2 for pick function 


If the specified function is already disabled, the command is 
ignored. Likewise, if the specified device Is for an option 
which is not present, the command Is ignored; an error is 
not generated. 


This command disables the GIN function on the named 
device. It leaves the device and its port (if any) active and 
addressable for further action. 


The following command disables GIN for the graphics tablet 
locator function: 


GINDISABLE 8 
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SETUP COMMANDS 
GINENABLE, GINGRIDDING 


GINENABLE GINGRIDDING 


Enables Graphic Input (GIN) mode. Establishes a grid for use in graphics input (GIN) mode. 


GINENABLE device-function, 
number-of-GIN-events 


GINGRIDDING device-function, [xgrid, ygrid] 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


thumbwheels for locator function 
thumbwheels for pick function 
tablet for locator function 

tablet for pick function 

port O for locator function 

port O for pick function 

port 1 for locator function 

port 1 for pick function 

port 2 for locator function 

port 2 for pick function 


thumbwheels for locator function 
thumbwheels for pick function 
tablet for locator function 

tablet for pick function 

tablet for stroke function 

port O for locator function 

port O for pick function 

port 1 for locator function 

port 1 for pick function 

port 2 for locator function 

port 2 for pick function xgrid specifies the distance between the grid lines 
parallel to the x-axis. The power-up default is zero; if 
you do not enter a value for “xgrid” it is set to zero. 
The valid range is from 0 to 4095. 


number-of-GIN-events specifies the number of points 
whose position will be reported in a GIN-report- 
sequence before the device-function combination is 
automatically disabled. 


ygrid specifies the distance between the grid lines 

parallel to the y-axis. The power-up default is zero; if 
| you do not enter a value for “‘ygrid” it is set to zero. 

The following example enables the graphics tablet for five The valid range is from 0 to 4095. 

events of the locator function: 


GINENABL - 
ae Gridding is usually set by a host program when it puts the 


terminal into GIN mode. It can help you draw lines or locate 
points more precisely. 


The following command specifies the terminal’s thumb- 
wheels for the locator function and sets up a 100 x 100 grid 
for GIN input: 


GINGRIDDING 0 100 100 Cr 
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GININKING 


This command turns inking on or off for all subsequent 
operations of the specified locator or stroke function. 


GININKING device-function, itnking-mode 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


0 
8 
10 
24 
32 
40 


thumbwheels for locator function 
tablet for locator function 

tablet for stroke function 

port O for locator function 

port 1 for locator function 

port 2 for locator function 


inking-mode specifies whether Inking mode is on or 
off, and if on, when it starts inking. 


0 turn inking off 
1 turn inking on 
2 turn inking on (start from 
GINSTARTPOINT) 
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SETUP COMMANDS 
GININKING, GINPICKAPERTURE 


GINPICKAPERTURE 


Specifies the ‘a’’ square within which the graphics input 
device can “pick” an object. 


GINPICKAPERTURE [size] 


size specifies the length of a side of the square within 


which the graphics input device is centered. The 
default when the terminal is turned on or reset is 8. If 
you do not specify a size, the terminal defaults to 0. 


The following command specifies a pick aperture of 4. This 
creates a 4 x 4 square with the graphics input locator cen- 
tered in the square. If you attempt to “pick” an object, it 
must have its x and y coordinates within two units (plus or 
minus) of the locator device in order to be detected. 


GINPICKAPERTURE 4°r 
See the 4//0 Series Host Programmers Manual and the 


4110 Series Command Reference Manual for details on 
“picking” objects on the screen. 
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SETUP COMMANDS 
GINRUBBERBAND, GINSTARTPOINT 


GINRUBBERBAND 


This command turns rubberbanding on or off for all subse- 
quent operations of the specified locator function. Rubber- 
banding is not allowed for the pick and stroke functions. 


GINRUBBERBAND device-function, 
rubberbanding-mode 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


thumbwheels for locator function 
tablet for locator function 
port O for locator function 
port 1 for locator function 
port 2 for locator function 


rubberbanding-mode specifies whether Rubber- 
banding mode is on or off, and if on, when it starts. 
turn rubberbanding off 


turn rubberbanding on 


turn rubberbanding on 
(start at GINSTARTPOINT) 
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GINSTARTPOINT 


Sets the start point that will be used by the GINRUBBERBAND 
and GININKING commands. 


GINSTARTPOINT device-function, start-point 


device-function indicates the graphics input device | 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


thumbwheels for locator function 
tablet for locator function 

10 tablet for stroke function 
port O for locator function 

32 port 1 for locator function 

40 _ port 2 for locator function 


start-point is the start-point at which GIN-inking or 
rubberbanding begins, in x- and y-coordinates. The 
valid range for both coordinates is from —2°' to 23'—1. 
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GINWINDOW 


Sets a window in terminal Space which can be used by the 
GINAREA command. 


GINWINDOW first-corner, second-corner 


first-corner is a corner of the window in terminal 
space into which a GIN device area is mapped. The 
range of valid values is 0 to 4095 for both x and y 
coordinates. 


second-corner Is another corner of the window in 
terminal space into which a GIN device area is 
mapped. The range of valid values is 0 to 4095 for 
both x and y coordinates. 


The x- and y- coordinates you assign are sorted so that any 
two opposite corners specify the rectangle. 
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SETUP COMMANDS 
GINWINDOW, HCCOPIES 


HCCOPIES (Option 09) 


Sets the number of color hardcopies produced each time 


you press the HARD COPY key, or the terminal receives a 
< hardcopy > or <4010-hardcopy > command. 


HCCOPIES number 


number is an integer in the range O through 65535 


that indicates the number of hardcopies to produce 
for each request. 


This command sets the number of copies produced by each 
hardcopy request. It requires the Option 09, 4691 Color 
Graphics Copier Interface, and a color copier attached to 
the terminal. A hardcopy request occurs when: 


© You press the HARD COPY key (either shifted or 
unshifted). 


© The terminal receives a <hardcopy > command. 


© The terminal receives a < 4010-hardcopy > command. 


If you specify zero for the number of copies (or omit the 
parameter), one copy is produced. 


The color hardcopier interface must be currently selected to 
produce acolor hardcopy from a regular hardcopy request. 
See the HCINTERFACE command for more information. 


When the terminal is turned on, the number of copies Is 
always set to one. 
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SETUP COMMANDS 
HCDATARES, HCINTERFACE 


HCDATARES (Option 09) 


Sets the color resolution of data sent to the color hardcopier. 
(Memory) 


HCDATARES [resolution] 


resolution is an integer parameter that must have a 


value of 1 or 2. A value of 1 sets one-byte color resolu- 
tion. A value of 2 sets two-byte color resolution. If 
omitted, one-byte resolution is set. 


One-byte color resolution formats data sent tc the color 
hardcopier with one-byte resolution (two-bit precision) for 
each of three colors: red, green, and blue. Two-byte color 
resolution formats data with two-byte resolution (four-bit 
precision) for each of these colors. 


Two-byte resolution copies terminal colors more precisely, 
but slows data transfer. In addition, if you copy data from 
SC: (the screen contents) to a disk file, more storage space 
is required. 


The setting is remembered when the terminal is turned off 
or reset. 
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HCINTERFACE (Option 09) 
Sets the hardcopy interface the terminal uses to produce a 
hardcopy. 

(Memory) 


HCINTERFACE ee 
color 


mono is a Keyword specifying that the terminal use 
the monochrome hardcopy interface. 


color is a keyword specifying that the terminal use the 
color hardcopy interface. This interface is used with 
the 4691 Color Graphics Copier. 


Either a monochrome copier or a color copier can produce 
hardcopies. The two types of copier use different interfaces 
to the terminal. The HCINTERFACE command lets you 
choose which of the two interfaces the terminal uses when it 
produces a hardcopy. | 


Hardcopies are requested in three ways: 


@® You press the HARD COPY key (either shifted or 
unshifted). 


@ The terminal receives a <hardcopy> command. 


© The terminal receives a <4010-hardcopy > command. 


The hardcopy interface can be selected by either a 

< select-hardcopy-interface > command from a program 
(see 4110 Series Command Reference) or a HCINTERFACE 
command issued by the operator. The copier connected to 
the selected interface is used for all hardcopy requests until 
a different interface is selected. 


The default interface when the terminal is turned on or reset 
is monochrome. 
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FHCORIENT 


Sets image orientation on color hardcopies. 


(Memory) 


HCORIENT 


horizontal 
vbotiom 
vcenter 
viop 


(Option 09) 


horizontal is a keyword that matches the long axis of 
the image to the long axis of the media. 


vbottom is a keyword that matches the long axis of 
the image to the short axis of the media and positions 
the image at the bottom of the media. 


vcenter is a keyword that matcnes the long axis of the 
image to the short axis of the media and positions the 
image at the center of the media. 


vtop is a keyword that matches the long axis of the 
image to the short axis of the media and positions the 
image at the top of the media. 


HCORIENT is one of the commands Option 09 provides for 
using the 4691 Color Graphics Copier. This command sets 
the orientation of the hardcopy image with respect to the 
hardcopy media (the paper or transparency on the copier). 
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SETUP COMMANDS 
HCORIENT 


Figure 6-5 shows the possible orientations of the image with 


respect to the media. 


The orientation applies only to the 4691 Color Graphics 
Copier. The setting is retained when the terminal is turned 


off or reset. 


IMAGE 


MEDIA 
A. 


horizontal 


IMAGE 


C. it MEDIA 


-yveenter 


IMAGE 


B. MEDIA 
ybottom 
D. set 
viop 4665-37 _ 


Figure 6-5. Orientation of Copier Images to Media. 
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HCRESERVE 


HCRESERVE (Option 09) 

Suppresses polling of other devices connected to a 4691 

color copier (with an Option 02 multiplexer), and reserves 
the color copier’s attention for the terminal. 


HCRESERVE {yes\ 
no 


yes is a keyword indicating that the terminal restricts 
the color copier from polling other connected devices. 


no is a keyword indicating that the color copier is free 
to poll other connected devices. This is the factory 
default setting. 


If your 4691 Color Graphics Copier is equipped with Option 
02 (the four-channel multiplexer), then the copier can poll 
up to four different devices and make copies from any of 
those devices. When the terminal is connected as one of 
those devices, the following command reserves the copier’s 
attention and prevents it from polling other devices: 


HCRESERVE yes 


After you issue a hard copy request and the copy is com- 
pleted, the copier restores device polling. (You can request 
a hard copy by pressing the HARD COPY key, by issuing 
the “Hardcopy” escape command, or by issuing a COPY or 
SPOOL command with HC: as the destination.) 


By setting HCRESERVE yes, you can remove copier paper, 
insert film, and make your copy without another device 
interfering. Or, if you have several copies to make and want 
your copies to be made sequentially, without interruption 
from another connected device, set HCCOPIES to the num- 
ber of copies required and then restrict device polling with 
HCRESERVE yes; when all the copies are made, the copier 
resumes polling. 


lf another device has reserved the copier when you request 
a hard copy (either by pressing the HARD COPY key or by 
issuing a “Hardcopy” command), the red light in your 
HARD COPY key starts to blink, indicating that the copier is 
busy. The light continues to blink until the copier accepts 
your copy request. 


If you try to COPY or SPOOL a file from the disk to the cop- 
ier and the copier is busy, the terminal reports a context 
error and the copy is not made. 
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NOTE 


If you issue COPY SC: to HC: when the copier is 
reserved, the copier resumes device polling after it 
completes the copy. The terminal’s HCRESERVE 
status, however, shows that the terminal’s attention 
is still reserved, even though the copier is polling all 
devices. You can correct the status by issuing 
HCRESERVE no. 


If another device has already reserved the copier when you 
issue HCRESERVE yes, the terminal acts as if the copier is 
busy; that is, the light in the HARD COPY key blinks until 
the copier is free to see the HCRESERVE request from your 
terminal. : 


If you reserve the copier and then decide not to make a hard 
copy, restore device polling by pressing RESUME on the 
4691 multiplexer and by issuing this command: 


HCRESERVE no 


Pressing RESUME on the multiplexer does not reset the 
status of HCRESERVE on the terminal. 


You can also press the CANCEL key (the combination of the 
Shift and LOCAL keys) to abort a copy in progress. Pressing 
the CANCEL key, however, may abort other operations that 
are in progress (for example, pressing CANCEL temporarily 
halts host communications because it empties the commun- 
ications queue). 


NOTE 


Do not press CANCEL until the copier has com- 
pleted its paper-loading procedure. If the copier is 
still trying to load paper, it remains tied up, waiting 
to receive data from the terminal. You must press 
CANCEL again, after the copier has completed its 
paper-loading procedure, to free the copier from 
this wait state. 


If the copier is not connected to the terminal when you issue 
HCRESERVE yes, the terminal reports an error. 
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IGNOREDEL 


Specifies whether or not the terminal ignores the Delete 
(Rubout) character. 
(Memory) 


IGNOREDEL i 
no 


yes is a keyword indicating that the delete character 


should be ignored. 
no is a keyword indicating that the delete character 


should not be ignored. This is the factory default. 


You should only set this parameter to “yes” if your program 
uses §c? as a substitute for the OL in graphics. 


The following command changes the setting of IGNOREDEL 


to “yes”: 


IGNOREDEL Cr 
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IGNOREDEL, KEYEXCHAR 


KEYEXCHAR 


Specifies the “key execute delimiter” character. 
(Memory) 


KEYEXCHAR char 


char specifies the “key execute delimiter.” Any ASCII 


character can be used, but it is best to choose one 
that is not used in a typical text string. The factory 
default is °. (ASCII 16, or Ctrl-P from the keyboard). 


The “key execute delimiter’ determines whether a macro is 
expanded by the terminal or the host. When a macro is 
being expanded by the host and the terminal encounters 
the key execute delimiter, the direction is reversed so the 
terminal is executing the macro. When it encounters 
another key execute delimiter, it causes the host to begin to 
expand the macro again. 


If the terminal is in Local or Setup mode, all macros are 
expanded locally and the key execute delimiter is ignored. 


The following command would define ©n as the key execute 
delimiter: 


KEYEXCHAR 24 Cr 


For an example of the use of the key execute delimiter, see 
the DEFINE command earlier in this section. 
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LFCR, LOAD 


LFCR 


Specifies whether a line feed character sent to the terminal 


display is interpreted as a line feed or a line feed + carriage 


return. 
(Memory) 


LFCR se 
no 


yes is a keyword indicating that the terminal should 
display ‘r (line feed) as line feed + carriage return. 


no is a keyword indicating that the terminal should not 
attach a carriage return character to each ‘+ (line 
feed) sent to the display. 


A carriage return causes the cursor to move to the left mar- 
gin of the current line; a line feed moves the cursor down 
one line from its current position. A carriage return + line 
feed combination moves the cursor to the left margin of the 
next line. 


NOTE 


This command affects line feed characters to the 
terminal display only. It does not affect characters 
sent to the host or transferred during file opera- 
tions. 


The following command would cause the terminal to attach 
the carriage return character to the line feed: 


LFCR &r 


When the terminal is in Local mode, it is necessary to 
change the parameter to “yes” if you want to get the car- 
riage return + line feed combination by pressing just the 
Line Feed key. 


LOAD 


Reads a file and executes it as a command file (as if com- 
mands were being received from a host with the terminal 
not in Setup mode). 


LOAD source 


source is the source of the file to be read and exe- 
cuted. Valid sources are: | 


HO: The host port. 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, the device 
FO: is assumed. (Option 42 or 43) 


F1:filename A file on the flexible disk in drive 1. 
(Option 43) 


msd:filename The msd: parameter is a mass-stor- 
age device address chosen from the 
list SO— S7, TO— T7,..., Z0 — Z7 
(see the Device Names discussion at 
the beginning of this section). 
(Option 45, 46, or 47) 


One of the peripheral ports. 
(Option 10) 


The DMA interface (Option 3A) 


NOTE 


File access on any device is restricted to files 
marked with the current user number. Thus the 
LOAD command will only load and execute a file 
marked with the current user number. 


Pressing the CANCEL key cancels the loading of a file. All 
other input to the terminal is queued until the file is loaded 
or the operation is canceled. 


Nesting of LOAD commands is allowed. That is, a file being 
loaded can in turn contain a LOAD command, and so on. 
LOAD commands can be nested five deep. 


This command loads the file named INITLIZE from the disk 
in drive 0. 


LOAD INITLIZE Cr 
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LOCKKEYBOARD 


Locks the terminal’s keyboard. 


LOCKKEY BOARD 


As soon as you enter the command, the keyboard is locked. 


When the keyboard ts locked you can still press the keys, 
but the characters are not echoed on the screen. The termi- 
nal’s bell rings when you press any key except Break or 
CANCEL. 


The keyboard should usually be locked and unlocked by the 
application program. 


CAUTION 


£S\ SL SL PSS DT PS IN 


Pressing the CANCEL key or the RESET button 
may cause you to lose information on the screen or 
halt other terminal operations in process. Do not 
do so unless you are sure you will not lose impor- 
tant data. 


You can unlock the keyboard by pressing the CANCEL key, 
the Break key, or the RESET button. 
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SETUP COMMANDS 
LOCKKEYBOARD, LPOS 


LPOS (Option 42, 43) 


Activates the “local programmability” operating system. 


LPOS 


If the operating system has not been loaded (is not resident 
in terminal memory), then this command causes it to be 
loaded from a file named ‘LPS.SY9Q’, located on a local 
programmability disk mounted in drive O. If this file is not 
found or does not contain a valid operating system, an error 
is detected. 


If the operating system is resident, but has been deacti- 
vated (with the SLEEP command — see the 4//0 Series 
CP/M-86 System Overview Manual, this command reacti- 
vates the operating system so that it resumes operating 
where it left off. 


When this command is issued, the operating system is 
activated but Setup Is not disabled. Setup mode super- 
sedes local programmability, so that you must exit Setup 
mode before local programs can run. You can enter Setup 
mode as often as you want, but use of local programs is 
suspended until you exit Setup mode. 


When local programmability is activated, the LED in the 
LOCAL key is turned on and further communications from 
the host are placed in the input queue (as if the terminal 
were in Local mode). The operating system remains active 
until the terminal is reset or powered off, or until the local 
programmability SLEEP command is issued. 


While local programmability is active, if the LED in the 
LOCAL key is on, an operator can interact directly with the 
operating system or a local program. When the LOCAL key 
light is off, the terminal reacts in the normal way to host 
communication. 


REV, JAN 1984 6-57 


SETUP COMMANDS 
PAGEFULL, PARITY 


PAGEFULL 


Specifies action to be taken when the “page full” condition 
occurs. 
(Memory) 


none 
PAGEFULL }j stop 

autocopy 

break 


none is a keyword meaning that no action is taken; 
when the cursor reaches the last line of the display, it 
returns to the upper-left corner and continues, writing 
over any text already there. This is the factory default. 
If you enter the command word with no parameter, it is 
set to “none.” 


stop is a keyword meaning that when a page full 
condition occurs, the terminal stops displaying text. 
Incoming text is stored in the input queue and dis- 
played when the page full condition is cleared. 


autocopy is a keyword meaning that when a page full 
condition occurs, the terminal makes a hardcopy of 
the screen, then erases the screen and continues. 
While the hardcopy is being made, incoming text is 
stored in the terminal’s input queue. 


break is a Keyword meaning that when a page full 
condition occurs, the terminal sends an interrupt to 
the host to discontinue the sending of information 
(equivalent to pressing the Break key). 


If flagging is not being used (see the FLAGGING command 
in this section, the communications overview in Section 5, 
and the 47/0 Series Host Programmers Manual) the input 
queue may be overrun when you use “‘autocopy,” due to the 
time it takes to make hardcopy. If this happens, you may 
want to implement a flagging mechanism or use the 
QUEUESIZE command to be sure that the input queue is 
large enough so that it is not overrun. 


The following command sets the terminal so that when a 
page full condition occurs, it makes a hardcopy, erases the 
screen, and then continues. 


PAGEFULL autocopy Cr 
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PARITY 


Specifies the kind of parity used by the terminal for check- 
ing input and when transmitting to a host. 
(Memory) 


none 
high 
PARITY < even 
odd 
data 


none means that the parity bit is set to O for transmis- 
sion of data. 


high means that the parity bit is set to 1 for transmis- 


sion of data. 


even means that the sum of the bits in the byte must 
be even for output. 


odd means that the sum of the bits in the byte must be 
odd for output. 


data means that all eight bits are used to send data 
for output. 


Parity is a means for verifying the accuracy of communica- 
tion between the terminal and a host computer. The terminal 
does not check parity on input, but it can be set to transmit 
data according to the host computer’s parity convention. 


The following command sets the terminal to transmit odd 
parity: 
PARITY odd Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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PASSIGN (Option 10) 
Assigns a device driver and/or an identification code to the 
specified port. 

(Memory) 


PASSIGN port, device 


port identifies the port to which a device driver and/or 
identification code is assigned. Valid port specifica- 
tions are: 


PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


device is an integer that identifies the device driver 
that is assigned to the specified port. Valid device 
drivers are: 


Device Mieaning 


4643 Tektronix 4643 line printer. 


4662 Translates terminal commands into 
4662 commands and 4662 commands 
into terminal commands; the plotter 
must be used in Block mode. 


Does not translate commands 
between the terminal and 4662. 


4662/NT 


4662/MP Same as “4662” driver, but includes a 
pen changing support added by the 


plotter’s multiple-pen option. 


Translates terminal commands into 
4663 commands and 4663 commands 
into terminal commands; the ploiter 
must be used in Block mode. 


Translates terminal commands into 
4663 commands and 4663 commands 
into terminal commands; the plotter 
must be used in Continuous Communi- 
cations mode (use DC1/DC3 or 
CTS/DTR flagging). 


4663/NB 


Does not translate commands 
between the terminal and 4663; plotter 
must be used in Continuous Communi- 
cations mode. 


4663/NT 


General purpose; supports any Tektronix 
device with an RS-232 connector. 
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SETUP COMMANDS 
PASSIGN 


lf you attach a device to a port, the device must be compati- 
ble with the assigned driver. 


The following command assigns the 4663 device driver to 
peripheral port O: 
PASSIGN PO: 4663 Cr 


The following command assigns the general purpose 
device driver to peripheral port 2: 


PASSIGN P2: PPORT Cr 
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SETUP COMMANDS 
PBAUD, PBITS 


PBAUD (Option 10) 
Assigns a rate for transmitting and receiving data for the 
specified port. 

(Memory) 


PBAUD port, baudrate 


port indicates which port is receiving a baud rate 
assignment; valid port assignments are: 


PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


baudrate is an integer which specifies the rate at 
which data will pass through the assigned port. The 
factory default is 2400. 


The baud rate that you assign to each port must be compati- 
ble with the baud rate of the device you attach to the port. If 
it is not, there will be communications problems. 


Valid baud rates are: 


134 (sets baud rate to 134.5) 
150 
300 
600 
1200 
1800 
2000 
2400 
3600 
4800 
7200 
9600 


The following command sets the baud rate at 1200 for 
peripheral port 2: 


PBAUD P2: 1200 °r 
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PBITS (Option 10) 


Specifies the stop bit and data bit conventions for the indi- 
cated peripheral port. 
(Memory) 


PBITS port, stopbits, databits 
port indicates the port for which the stop bit and data 
bit conventions are specified. Valid ports are: 


PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


stopbits is an integer specifying the minimum num- 


ber of bits following the data bytes in the communica- 
tions with the device attached to the port. The 
integers 1 and 2 are valid; the factory default is 2. 


databits indicates the length in bits of the data bytes 

used to communicate with the device attached to the 
port. The integers 5, 6, 7 and 8 (representing 5-bit, 6- 
bit, 7-bit and 8-bit bytes) are valid. The factory default 
is 8. 


Both “stopbits” and “databits” for a port must be compaiti- 
ble with the device that is attached to that port. If they are 
not, there will be a communications problems. 


The following command sets the data bit size to 7 and stop 
bits to 1 for peripheral port 0: 


PBITS PO: 1 7 Sr 
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PCOPY (Option 10) 


Establishes a two-way path between two devices. 


PCOPY source to destination 


source indicates the device which initiates and termi- 
nates the communication. Valid devices are: 


HO: the host port 

PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


to is a keyword that indicates the flow of the copy — 
from the source to the destination. 


destination specifies the device that is originally on 
the receiving end of the communication path. Valid 
devices are: 


HO: the host port 

PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


Since the data path is two-way, the two devices can carry on 
communication without involving the terminal. It is as if the 
terminal were not present and the two devices were con- 
nected directly to each other. 


The connection between the devices Is established by the 
PCOPY command. Communications must be started by the 
‘source’ device. The connection is broken when the termi- 
nal detects an end-of-file string (see PEOF) from the source 
device, when you press the CANCEL key, or if there is an 
error. 
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PCOPY 


The Setup mode prompt reappears on the screen when 
PCOPY is finished. The first 130 characters you type during 
PCOPY are stored in a queue. They are echoed and exe- 
cuted when PCOPY is finished. 


The following command allows the host and the device 
attached to peripheral port 2 to transfer data without involv- 
ing the terminal: 


PCOPY HO: to P2: ©r 


If the source device is the host (HO:), then you must arrange 
to begin the data stream before you enter the command in 
Setup mode, because once the command is entered the 
terminal will wait for a data stream from the host until an 
end-of-file comes from the host or the CANCEL key is 
pressed. 


Two ways to start the data stream appropriately are: 


1. Type the command to the nost to start the data stream 
without the end-of-command character outside of 
Setup mode, enter Setup mode, type in ihe PCOPY 
command with the desired destination, exit Setup 
mode, and type the end-of-command character. This 
should start the data stream from the host. If your host 
echos the characters typed on the terminal this method 
results in the end-of-command character being the first 
character in the data stream. 


2. Program the host sc that there is a delay between the 
time you enter the end-of-command character for the 
host-data-send command and the time the data stream 
begins to flow. If you use this method you should give 
yourself enough time to enter Setup mode and type the 
PCOPY command with the desired destination. 
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PEOF, PEOL 


PEOF (Option 10) 
Specifies the string to be sent to the peripheral; port when 
an end-of-file is detected by the terminal. 

(Memory) 


PEOF port, ":string®L 


port indicates the port for which the specified string 
denotes end-of-file. Valid ports are: 


PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


0, is the delimiter character, which must precede and 
follow the end-of-file string. The first character after 
the command word that is nota comma, space or edit 
character (see EDITCHARS) is the delimiter character 
for this command. 


string is a sequence of up to ten ASCII characters. 
The factory default is the null string. 


The port-EOF string that you assign to a port should be the 
same as the end-of-file string for the device attached to that 
port. 


In the following command, the slash (/) is used as the delim- 
iter and the ‘peripheral end-of-file” string is set to “????”. 


PEOF P1: /72772/ ©r 
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PEOL (Option 10) 
Assigns the end-of-line string to be used by the specified 
peripheral port. 

(Memory) 


PEOL port, °:string®L 


port indicates the port for which the specified string 
denotes end-of-line. Valid ports are: 


PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


D, is the delimiter character, which must precede and 
follow the end-of-line string. The first character after 
the command word that is not a comma, space or edit 
character (see EDITCHARS) is the delimiter character 
for this command. 


string consists of one or two ASCII characters. The 
factory default is carriage return. 


This string will replace carriage returns in data sent to the 
specified port when that port has been assigned a 4643 
device driver with the PASSIGN command. Refer to the 
4110 Series Command Reference Manual. 


In the following command, the end-of-line string for periph- 
eral port 0 is set to be a'r (line feed). 


PEOL PO: ‘F’ CR 
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PFLAG (Option 10) 


Sets the Flagging mode for the specified peripheral port. 
(Memory) 


PFLAG port, flag, [go], [stop] 


port indicates the port for which Flagging mode is 
being defined. Valid ports are: 


PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


flag indicates which of the three types of flagging is to 
be assigned. 


NONE 
CHAR 


no flagging (factory default) 
character flagging 


DTR = DTR/CTS (hardware) flagging 


go is a Single character parameter which can be spec- 
ified when “character flagging” is used. The terminal 
uses the “go” character to indicate that data trans- 
mission can proceed. Any ASCII character is valid; 
DC1 (ADE 17) is the factory default. If no character is 
specified, “go” defaults to DC1. 


stop is a character parameter which can be specified 
when “character flagging” is used. The terminal uses 
the “stop” character to indicate that data transmis- 
sion should stop. Any ASCII character is valid; DC3 
(ADE 19) is the factory default. If no character is spec- 
ified, “stop” defaults to DCS. 


The following example specifies that character flagging 
(with DC1 and DC3) is used at peripheral port 0: 


PFLAG Po: £r 
The command: 
PFLAG Pi: CHAR ? Cr 


causes peripheral port 1 to use character flagging with “?” 
as the “go” character and the default DC3 as the “stop” 
character. 
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PFLAG, PLOT 


PLOT (Option 10) 


Copies all currently visible segments to the specified output 
device. 


PLOT to destination 


to is a keyword that indicates the direction of informa- 
tion flow. 


desiination indicates the device to which the seg- 
ments will be copied. Valid choices are: 


HO: The host port. 


[FO:|filename A file on the flexible disk in drive O. If 
only filename is specified, the device 
FO: is assumed. (Option 42 or 43) 


A file on the flexible disk in drive 1. 
(Option 43) 


F1:filename 


msd:filename The msd: parameter is a mass-storage 
device address chosen from the list SO 


— $7, TO — S7,... ,Z0 — Z7 (see the 
Device Names discussion at the begin- 
ning of this section). (Option 45) 


One of the peripheral ports. 
(Option 10) 


NOTE 


If you use the PLOT command to create a file on a 
destination device, the new file is marked with the 
current user number. If you specify an existing 
filename with PLOT, the existing file is overwritten 
unless it is write-protected. Do not use the same 
filename tf the original file is unprotected and you 
want to save It. 


If you specify the host as destination, then be sure that the 
host is ready to accept the data. Otherwise you may lose 
your data or cause problems with the host. 


The following command copies the segments visible in the 
current view to the file named “picture1” on the disk: 
PLOT ito picturei Cr 
This command copies the segments to the device on 
peripheral port 2: 
PLOT to P2: Cr 
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PMAP, PPARITY 


PMAP (Option 10) 


Assigns one or more color indices to a plotter pen number. 


PMAP port, index, pen 


port indicates the port for which the index-to-pen 
assignment is valid. 


index specifies the color index assigned to a pen. A 
pen can have more than one index assigned to it. 
Valid index numbers are from —1 through 255. 


—1 means to map all color indices to the given pen. 


0-255 means to map the given color index to the 
given pen. 


pen specifies the pen to which a specified color index 
is mapped. Valid pen numbers are integers from 0 to 
the number of pens on the plotter: 


0 “unmap” the pen associated with a specific 
index. 


1-N specifies the pen number 


When data is drawn on the plotter, all lines with a mapped 
color index are drawn by the specified pen. Any index with- 
out a pen assignment is not drawn by the plotter. 


Mapping a color index to one pen automatically ‘“‘unmaps” 
that index from any other pen. This means that while one 
pen can have several indices assigned to it, an index can be 
assigned to only one pen at atime. 


Each time the terminal is turned on, all gray-scale indices 
are initialized to pen 0. 


The following command maps color index 6 to plotter pen 1, 
attached at peripheral port 2: 


PMAP P2: 6 1 &r 


This command “unmaps’” all indices from all pens: 
PMAP P1: -1 0 °R 
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PPARITY (Option 10) 
Assigns a Parity mode to the specified port. 
(Memory) 


low 
odd 
PPARITY port even 
high 
none 


port indicates the port for which parity is being 
assigned. Valid ports are: 


PO: peripheral port 0 
Pi: peripheral port 1 
P2: peripheral port 2 


low is a keyword indicating that the parity bit is given 
a value of 0. 


odd is a keyword indicating that the value of the parity 
bit is assigned such that the sum of all bits in the byte 
is even. 


even is a keyword indicating that the value of the 
parity bit is assigned such that the sum of all bits in 
the byte is even. 


high is a keyword indicating that the parity bit is given 
a value of 1. 


none is a keyword indicating that there is no parity 
check. 


A standard ASCIl character with parity would have seven 
data bits (see PBITS) and one parity bit. 


The following command sets the terminal for even parity 
checking on peripheral port 2: 


PPARITY P2: even Cr 


4115B OPERATORS 


PROMPTMODE 


Specifies whether or not the terminal is in Prompt mode. 


PROMPTMODE | yes 
no 


yes is a keyword which causes the terminal to enter 
Prompt mode. 


no is a keyword which causes the terminal to exit 
Prompt mode. This is the default. 


When the terminal is in Prompt mode, data from the termi- 
nal is stored in a queue and transmitted to the host when it 
is prompted to do so. If you press the CANCEL key, the 
terminal flushes the queue. If you turn Prompt mode off, all 
the characters in the queue are sent to the host. 


The character string that the terminal recognizes as a 
prompt is defined by the PROMPTSTRING command. After 
the terminal enters Prompt mode, the first prompt string is 
displayed. Subsequent prompt strings are executed, but not 
displayed. If you press the CANCEL key, Prompt mode 
Starts over — that is, the first prompt after pressing CAN- 
CEL is displayed and subsequent prompts are executed. 


The following command would cause the terminal to enter 
Prompt mode: 


PROMPTMODE yes Cnr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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PROMPTMODE, PROMPSTRING 


PROMPTSTRING 


Specifies the prompt sequence. 
(Memory) 


PROMPTSTRING :string?t 


D. is the delimiter character, which must precede and 
follow the prompt sequence. The first character after 
the command word that is not acomma, space, or edit 
character (see EDITCHARS) ts the delimiter character 
for this command. 


string is a sequence of up to ten ASCII characters. 
The factory default is the null string. 


The prompt string you specify must match the prompt string 
actually sent by your host computer. 
The following command sets the prompt string to “+ &%”: 


PROMPTSTRING /+&%/ Cr 
This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 


not, you may need to consult with a system programmer for 
your host computer before using this command. 
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PROTECT (Options 42,43,45) 


Specifies the write-protect status for a file. 


PROTECT filename _ [yes] 
[no] 


filename is the name of the file to be accessed. Valid 
choices are: 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, the device 
FO: is assumed. (Option 42 or 43) 


Fi:filename A file on the flexible disk in drive 1. 
(Option 43) 


msd:filename The msd: parameter is a mass-storage 
device address chosen from the list SO 
— $7, TO—T17,...,Z0 — 27 (see the 
Device Names discussion at the begin- 
ning of this section). (Option 45) 


NOTE 


File access on any device is restricted to files 
marked with the current user number, if — 
relevant. You can only protect or unprotect 
Jiles marked with the current user number. 


yes is a keyword meaning that the file should be write- 
protected. If you specify neither yes nor no, yes is 
assumed. 


no is a keyword meaning that the file should be unpro- 
tected. 


A protected file must be unprotected before it can be 
deleted or overwritten. If the disk drive is write-protected (as 
shown by the WRITE PROTECT light on the front of the 
drive), it must be unprotected before you can use PROTECT 
to change the protection status of any file on the disk in that 
drive. 


The following command write-protects the file named | 
SAVEDATA on the disk in drive 1: 


PROTECT F1: SAVEDATA ©r 


QUEUESIZE 


Specifies the size of the terminal’s input queue. 
(Memory) 


QUEUESIZE bytes 


bytes is an integer from 1 to 65535, specifying the 


number of bytes in the input queue. The factory 
default is 300. 


When the terminal receives data from the host faster than it 
can be processed, it stores the data in the input queue. 


If the input queue fills up and flagging (see FLAGGING) is 
not being used, the terminal ignores incoming data or text 
until there is more room in the queue. If flagging is used and 
the queue fills up, the terminal flags the host to stop sending 
data; then when there is room in the queue for more data, 
the terminal flags the host to resume sending data. 


The following command sets the input queue to 500 bytes: 


QUEUESIZE 500 °r 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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RENAME (Option 42, 43, 45) 


Changes the name of a file on the specified disk. 


RENAWE oldname to newname 


oldname is the current name of the file. 


to is a keyword which helps distinguish between 


current name of the file and its new name. 
newname is the new name of the file. 


See the File Names discussion earlier in this section 
for file name formats. 


This command changes the name of the file called o/dname 
to newname. 


NOTE 


You cannot RENAME a file to a different disk or 
device location. RENAME changes only the name 
of the file. 


An error results if a file already exists with the newly speci- 
fied name. An error also occurs if no file with the specified 
“oldname’” exists, or if the file you are attempting to rename 
or the disk it resides on Is write protected (by the WRITE 
PROTECT switch, the write protect notch in the disk, or by 
the PROTECT command). 


The following command changes the file named 
“wrong.old”’ to “right”: 


RENAME wrong.old to right Cr 
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RENAME, RENEW 


RENEW 


Erases the specified viewport and redraws all visible seg- 
ments. 


RENEW view 


view is an integer parameter in the range from —1 to 


64. A value of —1 renews all views; 1-64 renew the 
specified view. A value of zero renews the current 
view. 


When a viewport is renewed, it is completely updated to 
reflect all changes made to it since it was updated last. See 
the FIXUP command for more details. 
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REOM, RLINELENGTH 


REOM RLINELENGTH 

Specifies when the end-of-message indicator is sentina Specifies the maximum length of a terminal report sent to | 
series of Graphics Input (GIN) reports. the host computer. 

(Memory) 


RLINELENGTH length 
REOM }1| 
0 


length is an integer in the range from 0 through 65535 
that specifies the maximum length in characters for 

1 specifies that the end-of-message indicator is sent 
after each report element and at the end of the report. 


reports the terminal sends to the host computer. The 
factory default is 0. A specification of 0 sets the maxi- 


This is the factory default. mum length to infinity. 


0 specifies that the end-of-message indicator is sent 
only at the end of the report. See the 4/10 Series Command Reference Manual for details. 


This command should be set by the applications program. If 
it has not been, you may need to see a system programmer 
for your host system for more information. 
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RSIGCHARS 


Assigns the signature characters to be used within report 
messages which the terminal sends to the host computer. 


RSIGCHARS  report-type-code, sig-char, 
term-sig-char 


report-type-code specifies the type of report for 
which these signature characters will be used. If this 
is a GIN device-function code, then the signature 
characters defined in this command will be used in 
GIN-report-sequences for that device-function code. If 
this parameter is —3, then these signature characters 
are used in non-GIN report messages. If the parame- 
ter is -2, these signature characters are used only 
when responding to REPORT-GIN-POINT: -2 com- 
mands. If the parameter is minus one, then these 
signature characters are used in all report messages 
(both GIN reports and non-GIN reports). 


sig-char is the numeric equivalent of the ASCII char- 
acter which is to be used as the sig-char in reports of 
the specified type. If the sig-char is set to Nu — 
numeric equivalent of zero — then that sig-char is 
omitted from reports sent to the host. 


term-sig-char specifies the character to be used as 
the term-sig-char in reports of the specified type. If the 
term-sig-char is Nu, then it is omitted in reports sent to 
the host. 


lf GIN is enabled for more than one device at atime, for best 
results set different sig-char and term-sig-char parameters 
for each enabled GIN device. This is necessary in order that 
the host computer can parse (interpret) the interleaved GIN- 
report-sequences which can be sent to the host if more than 
one GIN device Is active. 


Also, if non-GIN reports are requested while GIN is enabled, 
then different sig-chars and term-sig-chars are needed to 


distinguish non-GIN reports from GIN reports. 


On power up, all signature characters are initialized to “Nu. 
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SAVE 


Saves the specified item to the specified file or device. 


mac mac-id 

SAVE } seg seg-id to destination 
ras numpix 
run numpix 


mac is a keyword indicating to Save a macro. 


mac-id is either an integer or “‘all’”. When mac-id is 
“all”, all macros are saved. An integer identifies a 
particular macro to save. The integer must fall within 
one of the following ranges: 


—22768 through —32742 

—32740 through —32737 

—32608 through -—32513 
—1 through 32767 


The integer —1 indicates all macros. Other integers 
indicate macros as explained in the description of the 
DEFINE command in this section. 


seg is a keyword indicating to save a segment. 
seg-id is either an integer or ‘‘all”. When seg-id is 


“all”, all segments are saved. An integer indicates a 
specific segment. Valid integers are: 


—4 to plotter — same as the PLOT com- 
mand. 

—3 all segments in the current matching 
class 

—1 all existing segments 


1 to 32767 a specific segment 


See the 4//0 Series Host Programmers Reference 
Manual for details. 


ras is a keyword meaning to Save pixels using “raster 
write’ commands. 


run is a keyword meaning to save pixels using “run 
length write’ commands. 


numpix is a parameter used with ras and run that 
specifies the number of pixels to save. li must be an 
integer in the range -1 through 32767. A-1 value 
means to save all pixels in the viewport. An integer in 
the range 1 through 32767 means io save that num- 
ber of pixels starting from the current beam position. 


6-63 


SETUP COMMANDS 
SAVE, SNOOPY 


to is a keyword to help you remember the flow of data. 


destination indicates the device to which data should 
be saved. Valid choices are: 


iW! The host port. 


[FO:]file name A file on the flexible disk in drive O. If 
only filename is specified, the device 
FO: is assumed. 
(Option 42 or 43) 


F1:filename A file on the flexible disk in drive 1. 
(Option 43) 


msd:filename The msd: parameter is a mass-storage 
device address chosen from the list SO 
— $7, TO—T7, ..., Z0 — Z7 (see the 
Device Names discussion at the begin- 
ning of this section). (Option 45) 


One of the peripheral ports. 
(Option 10) 


The DMA interface (Option 3A) 


NOTE 


File access on any device is restricted to files 
marked with the current user number, if relevant. If 
you SAVE to an existing file, that file must be 
marked with the current user number. If you spec- 
ify a filename not marked with the current user 
number, a new file is created and marked. 


Graphics and macros that are saved can be put back into 
terminal memory with the LOAD command. 


If you specify the host as destination, then be sure that the 
host is ready to accept the data stream, or you may lose 
data or cause communications problems with the host. 


The following command will save all current segments to 
the device attached to peripheral port 2: 

SAVE seg all to P2: Sr 
This next command saves macro number 579 in the file 
named “macfile” on the disk in drive 0: 


SAVE mac 579 to macfile ©r 


For more detailed information on pixel saving operations, 


see the 41/0 Series Host Programmers Manual and the 4110 


Series Command Reference Manual. 
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SNOOPY 


Specifies whether the terminal should display control char- 
acters instead of executing them. 


SNOOPY {yes} 
no 


yes is a keyword indicating that Snoopy mode should 
be initiated. 


no is a keyword indicating that Snoopy mode should 
be terminated. This is the default. The “no” specifica- 
tion puts the terminal in Alpha mode. 


When the terminal is in Snoopy mode (but not in Setup 
mode) it displays control characters instead of executing 
them. When the terminal is in Setup mode and Snoopy 
mode at the same time, it displays the control character 
then executes the control character. 


Since Snoopy mode displays characters which would other- 
wise be executed, it is a handy tool for debugging code. 


In Snoopy mode, characters which are normally filtered out 
during communications to the host are not displayed. That 
means, for example, that even though the terminal is in 
Snoopy mode, the prompt string, block headers, and flag- 
ging characters are not displayed. 


The terminal displays control characters using the two- 
character abbreviation of control characters shown in the 
ASCII code chart (Appendix D). 


Snoopy mode can also be used to examine the contents of 
key macros without executing any commands in them. To 
do so, first enter Setup mode and give the following com 
mand: | | 


SNOOPY YES rr 


After entering this command, exit from Setup mode and 
enter Local mode. Now when you press a key which has a 
macro assigned to it, that macro is displayed but not 
expanded. 


To leave Snoopy mode, enter Setup mode and give the 
following command: 


SNOOPY NO Cr 
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SPOOL ; | 5 ped as 
F1:filename A file on the flexible disk in drive 1. 

Copies data from one device to another, allowing the termi- (Option 43) 

nal to be used for other functions at the same time. msd:filename The msd: parameter is a mass-storage 
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SPOOL source to destination 


source indicates the source device. Valid 
Sources are: 


HO: The host port. 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, device FO: is 
assumed. (Option 42 or 43) 


Fi:filename A file on the flexible disk in drive 1. 
(Option 43) 


msd:filename The msd: parameter is a mass-storage 
device address chosen from the list SO 
—S$7,T0—T7,...,Z0—2Z7 (see the 
Device Names discussion at the begin- 
ning of this section). (Option 45) 


PO: 

P1: One of the peripheral ports. 
P2: (Option 10) 

DM: The DMA interface (Option 3A) 


to is a keyword that indicates the direction of the 
SPOOL operation. 


destination specifies the destination of the copy — 
that is, where the data Is to be copied. When the desti- 
nation is a filename with no device specifier, a file with 
the given filename is created on the disk in drive 0. 
Valid destinations are: 


HO: The host port 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, device FO: 
is assumed. (Option 42 or 43) 


device address chosen from the list SO 
— $7, TO0—T/7,...,Z0— 27 (see the 
Device Names discussion at the begin- 
ning of this section). (Option 45) 

PO: 

Pi: One of the peripheral ports. 

P2: (Option 10) 


HC:{background] Acolor hard copy device. The 
background parameter must be either 
O or 1: when it is O or omitted, a black 
screen background copies as white; 
when it is 1, a black screen back- 
ground copies as black. (Option 09) 


The DMA interface (Option 3A) 


NOTE 


File access on any device is restricted to files 
marked with the current user number, when rele- 
vant. You can only spool a file that is marked with 
the current user number. [f the destination includes 
a filename, the resulting file is marked with the 
current user number. 


Once initiated, the SPOOL operation proceeds in the back- 
ground, allowing the terminal to be used for other opera- 
tions. Data is transferred from the source to the destination 
without destroying the source copy. 

Spooling continues until: 

O the terminal receives the end-of-file string. 

© the STOP command is issued. 


© there is a source or destination error. 
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If the “destination” is a disk drive, an output error can result 
because: 


@ there is no disk in the drive. 
® the disk in the drive is write protected. 


® the disk does not have enough room on it for the output 
file. 


If the last of these errors occurs, you should use a different 
disk. 


If the source is the host, you should either arrange for the 
data to be transmitted for the SPOOL before you enter 
Setup mode, or be aware that after you issue the command 
everything that comes from the host is considered data, 
including the remote character echo. 


All characters echoed from the host either before the data 
stream begins or while the data stream is flowing are sent to 
the destination device. 


This command copies “‘file 1” on disk drive 0 to the output 
device attached to peripheral port 2: 


SPOOL FO:file1 to P2: °r 
For restrictions on making hard copies using the COPY and 


SPOOL commands, see Using a 4691 Color Copier in Sec- 
tion 3, or the description of COPY in Section 6. 
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STATUS 


Reports the terminal’s general status, the status of a group 
of related parameters, or the setting of an individual termi- 
nal parameter. 


STATUS _ [cluster] 
[command] 


lf no parameter is entered, the terminal displays a 
general report of the terminal’s status. 


cluster is an undelimited alphabetic string specifying 
a status report of a group of related parameters. Valid 
clusters are: 


report/input 

general 

communications 

optional (optional communications) 
dialog (dialog area) 

3PPI 


command is an undelimited alphabetic string that 
specifies a command or group of commands for which 
you want status. You can use a complete command | 
name or abbreviation in either Setup or escape 
sequence format. If you enter an abbreviation, you 
receive status for all commands that begin with the 
abbreviation. This string can also use the escape 
character to give the status of parameters set with 
escape sequence commands. 


The following command generates a general report of the 
status of the terminal (Figure 6-6): 


STATUS rR 


This command reports the status of commands relating to 
the dialog area (Figure 6-7): 


STATUS DIALOG ©r 


This command reports the status of the BAUDRATE com- 
mand (Figure 6-8): 


STATUS BAUDRATE Cr 


When you abbreviate the name of a command, the terminal 
reports the status of all commands that begin with the 
abbreviation. For example, if you enter the following com- 
mand the terminal reports the status of all commands 
beginning with the character “E” (Figure 6-9): 


STATUS E ©r 
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lf you request a report for a command that is not stored in 
the terminal’s setup memory, there is no message. The 
cursor moves to the next line and displays the Setup mode 


prompt (*). 


If you give the full STATUS command, DABUFFER should 
be set large enough to hold the message, or else text at the 
top of the status message will be !ost! 


STATUS DIALOG 
DIALOG 
DABUPPER tcc tdwiaw erst 


DACTNOES. “ot, ake. (4 
DALINES. Seeman en. 40 | 
DAMODE. oc vac ee eee , REPLACE 
DASURFACE..... 000 1 es 


4665-39 


Figure 6-7. The Dialog Area STATUS Report. 
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Figure 6-8. The STATUS BAUDRATE Report. 
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Figure 6-9. The STATUS E Report. 


ee | oe apes 2 eee ae FULL 

“ BLOCKMODE, 1) ceS NO oe 
_ BHEADERS. TEEDEEIEEE Mieaprxe 'HE DRX 
— BLENGTH..... eee eee ee 256 2560 
| BCONTINUECHARS. cee et ee 
- BENDCHARS. oe : : oo SS OG Roe as: 
Pe eee 


4115B OPERATORS REV, JAN 1984 


OXMTDELAY OO, 6c ee 100: 


PARITY. Sete ta ey NONE 


--PROMPTSTRING. LP Reo: 
- PROMPTMODE. ee 
“SQUEUESIZE. .6. we a ee 300... © ee eee 
 FLAGGING..........., NONE Se eae 

“y FOMCHARS. v2 60s ae WS 

- ROUSTRING. 0 oc oe OG 
SO EOP SERING wea cce pes ee eR ee 
~ BREAKTIME. ee a eee 
YEU REANED gt Hecan 


OPTIONAL COMM 


Figure 6-6. The STATUS Report. 
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STOP STOPBITS 


Halts the current “spooling” operations. Specifies the number of stop bits used at the end of each 
character transmitted from the terminal. 


STOP (Memory) 


STOPBITS { | 


When a spool is halted, the output file is closed and all data 2 


that has already been transferred ts saved. 
1 indicates that the terminal appends one stop bit. 


The command is ignored if no spool is in progress. This is the factory default. 
2 indicates that terminal appends two stop bits. 


The purpose of the “stop bit” is to indicate the end of a data 
byte sent to the host. 


The following command sets the terminal to transmit two 
stop bits at the end of each byte: 

STOPBITS 2 Cr 
This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 


not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SFILTER (Options 13/14) 
Specifies the time and distance between points entered per 
stroke when the graphics tablet is in use. 


TBFILTER device-function, distance, time 


device-funciion is an integer parameter indicating 
the tablet is in use. The device-function must be set 
to 10. 


distance is an integer parameter specifying the mini- 
mum x or y coordinate distance the graphics cursor or 
pen must travel before another point is transmitted to 


the program. The valid range is from 0 to 4095. The 
default is 0 (distance filtering is not used). 


time is an integer parameter specifying the minimum 
number of milliseconds that elapse between succes- 
sive points transmitted to the program. The valid 
range Is from 0 to 32767. The default is 0 (time filter- 
ing is not used). 


Setting both distance and time to 0 disables all filtering activ- 
ity. See the 47/0 Series Host Programmers Manual discus- 
sion of GIN (Graphic Input). 


The following command sets the graphics tablet to locate 
every 100th point every 100 milliseconds: 


TBFILTER 10 100 100 Cr 


NOTE 


[f both the distance and time filters are active, 
both conditions must be met before a point ts 
transmitted. 
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TBHEADERCHARS (Options 13/14) 


Specifies the header characters used in graphics input 
reports. 


letters 


TBHEADERCHARS 
controi 


letters specifies the characters M, J, and O as the 
header characters. This is the default. 


control specifies the control characters (GS), (SUB), 
and (US) to be the header characters. 


This emulates the HEADER strap on the TEKTRONIX 4953 
Graphics Tablet control board found in 4010 Series termi- 
nals. For more details see the description of the < set- 
tablei-status-strap > command in the 4/10 Series 
Command Reference Manual. 
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TBSIZE (Options 13/14) 
The graphic tablets included with Options 13 and 14 have a 
slightly larger active area than the TEKTRONIX 4953 and 
4954 tablets used with earlier 4010 series terminals. To 
emulate the earlier tablets more closely, the < set-tablet- 
size > command is included in versions 2 and above of the 
firmware for Options 13 and 14. 


large 
TBSIZE ;small 


automatic 


large has the tablet operating as an option to a 4110- 
series terminal. The active area of the Option 13 tab- 
let is 121 square inches (11 x 11 in, or 279 x 279 mm). 
The active area of the Option 14 tablet is 1200 square 
inches (80 x 40 in, or 762 x 1016 mm). 


small is used when a smaller active area is required, 

to emulate more closely the 4953 and 4954 tablets 
used with earlier 4010 series terminals. The Option 13 
tablet emulates the 4953 tablet, with an active area of 
105 square inches (10.24 x 10.24 in, or 260 x 260 
mm). The Option 14 tablet emulates the 4954 tablet, 
with an active area of 1180 square inches (30.72 x 
38.4 in, or 780 x 975 mm). 


automatic is used when the tablet is enabled with an 
<enable-GIN > command from the host; the entire 
tablet area is used. When the tablet is enabled with 
the < enable-4953-tablet-GIN > command from the 
host, the smaller active area of the tablet is used, 
emulating the smaller active area of the 4953 and 
4954 tablets. 


The following command sets the terminal to use the smaller 
area of the 4953/4954 tablets. 


TBSIZESMALL Cr 
See the 4110 Series Host Programmers Manual and the 


4110 Series Command Reference Manual for detailed infor- 
mation concerning TBSIZE. 
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TBSTATUS (Options 13/14) 
Specifies whether or not the terminal status byte is sent 
when the graphics tablet pen is lifted away from the tablet 
surface. 


TBSTATUS _ out 
in 


out specifies that the status byte is not sent when the 
tablet pen is lifted away from the tablet surface. 


in specifies that the status byte is sent when the tablet 
pen is lifted away from the tablet surface. This is the 
factory default. 


This emulates the HEADER strap in the TEKTRONIX 4953 
Graphics Tablet board in 4010 Series terminals. For more 
information, see the description of the <set-tablet-status- 
strap > command in the 4/10 Series Command Reference 
Manual. 
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USERNUMBER 


Sets the user number that the terminal uses when access- 
ing files. 


USERNUMBER user-number 


user-number is an integer from 0 through 15. 


User numbers serve to keep the files for different users 
separate in a friendly, low-security environment. For exam- 
ple, each user sharing a given terminal workstation or mass 
storage device might use a unique user number. In this way, 
each user can copy, print, transfer, delete, or create files 
without danger of destroying or damaging another user’s 
data. 


When you enter a commana that includes a /device] 
filename parameter, for either a Source or destination 
parameter, the terminal accesses only information (on that 
device) that is marked with the current user number. For 
example, suppose your user number is 11. At the end ofa 
work session, you can give the command: 


COPY FO: WORKFILE.TMP to S1: WORKFILE.SAV 


The terminal copies your WORKFILE.TMP on the flexible 
disk in drive 0 to WORKFIiLE.SAV on the mass storage 


device in device S1: and marks the file with user number 11. 


This is also convenient for directory information. If you give 
the command: 


DIRECTORY F1: 
The terminal lists only files marked with user number 11. 
See also the following commands in this section: COPY, 


DELETE, DIRECTORY, DISMOUNT, FORMAT, LOAD, PRO- 
TECT, RENAME, SAVE, and SPOOL. 
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XMTDELAY 
Specifies how long transmission of data to the host is halted 
after the terminal encounters an end-of-message character 


(see EOMCHAR). 
(Memory) 


XMTDELAY ms 


ms is an integer parameter representing the number 


of milliseconds delay in transmission. The acceptable 
range of values is from 0 to 65535; the factory default 
is 100. 


The following command sets the transmit delay to 300 milli- 
seconds: 


XMTDELAY 300 Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you rnay need to consult with a system programmer for 
your host computer before using this command. 
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XMTLIMIT 


Specifies the upper limit for data transmission from the 
terminal to a host computer. 
(Memory) 


XMTLIMIT limit 


limit is an integer parameter indicating the fastest 


rate at which the terminal is to send data to a host. 
The range of valid values is from 110 to 65535; the 
factory default is 19200. 


If the host cmputer cannot effectively receive data ata arate 
at which the communications port is specified, you can use 
XMTLIMIT to cause the terminal to pace its transmission of 
data at the given limit. This lowers the effective baud rate 
without altering the baud rate itself. 


The following command sets the transmit limit to 1800 bits 
per second. 


XMTLIMIT 1800 rR 


This terminal operating parameter is host dependent. It 
should usually be set by an application program when it is 
executed from the host. If it is not, see a systems program- 
mer for your host computer for more information. See the 
4110 Series Command Reference Manual for additional 
details. 
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Appendix A 


ERROR CODES 


INTRODUCTION 


Each error condition which a 4110 Series terminal can 
detect has an error code and a severity level. 


When the terminal detects an error condition, it stores the 
error code and severity level in a limited-size queue for later 
retrieval by a REPORT-ERRORS command from the host. 


If the error’s severity level is greater than or equal to the 
current error threshold, then the terminal displays a mes- 
sage for the operator. When the terminal is powered up or 
reset, its error threshold is set to 2, so that the only errors 
displayed are those with a severity level of 2 or more. The 
error threshold can be changed with the SET-ERROR- 
THRESHOLD command from the host or the 
ERRORLEVEL setup command from the keyboard. 


Since the terminal has two command sets, TEK commands 
and ANSI commands, the error codes for the two sets are 
listed separately. TEK error codes begin with two alphanu- 
meric characters, while ANSI error codes begin with either a 
bracket ({) and a character, or a character and a space. 
Other than this difference, errors from the two command 
sets are treated the same. 
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SEVERITY LEVELS 


There are four severity levels, numbered from zero to three: 


© Level 0. Errors of severity level zero are hardly errors at 
all. The associated message begins with the words “'Ter- 
minal issues message...”. Typically, these errors occur 
for commands which are not installed. For instance, 
when 4112 commands are sent to a 4114, the terminal 
detects level zero errors. 


© Level 1. Level one errors are “warnings.” The corres- 
ponding messages begin with the words ‘Terminal 
issues warning ...”. Typically these occur when the com- 
mand is inappropriate: deleting a segment that does not 
exist, for example. 


O Level 2. Level two errors result from invalid commands. 
For instance, a command’s parameter may be outside 
the specified range. The corresponding message begins 
with the words “Terminal detects error ...”. 


© Level 3. Level three errors occur when the command is 
valid, but for some reason the terminal cannot execute 
the command. (For instance, there may be insufficient 
memory to hold all the information being included ina 
segment definition.) For these errors, the message starts 
with the word, “Terminal system error...’’. 
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ERROR CODES 


The error codes are each composed according to the follow- 
ing scheme: 


@ Each error code consists of four characters. 


@ In most error codes, the first two characters are the op 
code (operation code) for the command which causes the 
error. For example, error 1|A11 is associated with the SET- 
PICK-APERTURE command. 


Some errors, however, are associated with no particular 
command. For these errors, the first two characters area 
letter and a digit. For instance, error 1011 (invalid device- 
Junction code) can occur with many graphic input com- 
mands. Again, error J109 (disk hardware initialization 
error) can occur only when the terminal is turned on 
before any commands have been sent to it. 


@ The third character in an error code is a digit. Digits from 
1 to 9 name the parameter with which the error is associ- 
ated. Digit 0 indicates that the error is associated with 
the command as a whole: the op code itself is regarded 
as the “zeroeth parameter.” An error in the second 
parameter, for example, is indicated by the digit 2. Errors 
in parameters 10 and above are indicated by the digit 9. 


@ The fourth character in an error code is also a digit. The 
most frequently used digits here are 0, 1, 2, 3 and 9: 


0 Indicates an “existence problem.” The object referred 
to does not exist when it ought to exist, or does exist 
when it ought not to exist. 


1 Indicates an “invalid value.” 
2 Indicates an “out of memory problem.” 


3 A“‘context error.” The command is valid, but cannot 
be executed at this time. (For instance, trying toenda 
segment when no segment is currently being 
defined.) 


9 A hardware error prevents or halts execution. (For 
example, the door is open on a disk drive when you 
try to copy from it.) 
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For example, consider the ‘‘SOQ10” error code. Here, “SO” 
means the BEGIN-SEGMENT command, which has the 
syntax -cSO int. The ‘‘1” refers to the first (and only) param- 
eter of that command, which is the segment number. The 
“OQ” indicates an “existence problem;” the segment 
referred to already exists. 


Commands Not Installed in the Terminal 


Op codes beginning with letters from | to Z may occur in 
present or future 4110 Series terminals. When the terminal 
receives one of these escape-sequence commands and 
does not recognize that command, it detects an error of 
severity level zero. After detecting the error, the terminal 
then ignores all subsequent characters until it receives an 
Ec, Ss, Fs, or Ys character. (It does this so as to skip over any 
parameters for the unrecognized command.) 


For instance, suppose the terminal does not have Option 01 
installed, and the host sends it the following character 
sequence: 


EcODOFcKA1 


Since Option 01 is not installed, the terminal does not rec- 
ognize the SET-DUPLEX-MODE: 0 command, FcODO. On 
receiving the FcOD op code, it detects a type ODOO error 
(and displays the ODOO error message if the error threshold 
is set to zero). It ignores the following character, 0. On 
receiving the following §c, it resumes processing of the 
characters received, so that it correctly interprets and exe- 
cutes the ENABLE-DIALOG-AREA: 1 command, -cKA1. 


If your host program sends commands that may not be 
installed in all 4110 Series terminals, then these commands 
should be followed by other commands which are recog- 
nized by all terminals in the series. For instance, after issu- 
ing commands to change raster terminal (4112, 4113, 4115) 
only settings, the host could send a Ys character (the 
ENTER-ALPHA-MODE command) before sending any 
alphatext to the terminal. That way, if the program is also 
sent to a 4114 or 4116 terminal, the Y's character causes the 
terminal to resume normal processing of the characters it 
receives. 
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HARDWARE ERRORS In the first line, xx refers to the command (with the two-letter 
error code) and v7 refers to the number of the parameter that 
caused the error. In the second line of the hardware error, 
yy: is the device name and zzz refers to the error number 
listed in Table A-1. If you get a disk hardware error and can- 
not determine its cause using Table A-1, contact your local 


Tektronix Field Office for more information. 


Disk Hardware Errors 


If the terminal has any of the disk options (Options 42, 43, 
45, 46, or 47), it may issue disk hardware errors. The errors 
have this format: 


> > Terminal Detects Error xxn9 
>> Device yy: Hardware Error zzz 


Table A-1 
DISK HARDWARE ERRORS 


Device Device 
Description Explanation Description Explanation 
8” Floppy Drive No seek complete. 5% Floppy (cont) 32 Invalid command from disk 
(Devices FO: or F1:) Write fault. driver. 
Drive not ready. 34 System error. 
No track 0. 35 Power fail. 
Multiple drives selected. 48 RAM diagnostic failure. 
Insufficient capacity. 49 Program memory checksum 


Controller chip error. 


error. 


- ea 10-Megabyte 1or129 | No index detected from disk 
ae as Hard Disk drive. 
ID address mark not found. (4926 or 20r130 | Noseek complete from disk 
Data address mark not found. Option 46/47) drive. 
Record not found. 3o0r131 | Write fault from disk drive. 
Seek error. 4o0r132 | Drive not ready after it was 
DMA timeout error. selected. 
Write-protected. 6o0r133 | Track zero not found. 
Bad block found. 16 or 144 | ID field read error. 
Interleave error. 17 or 145 | Uncorrectable data error. 
Unable to determine a disk 18 or 146 | Address mark not found. 
format. 20 or 148 | Target sector not found. 
Invalid command from disk 210r149 | Seek error. 
driver. 24 or152 | Correctable data error. 
Insufficient internal data buffer. 25 or 153 | Bad track flag detected. 
Controller chip system error. 26 or 154 | Format error. 
54" Floppy (4925 or | 2 No seek complete. 28 or 156 pica a aaa to an 
4926 Option 25 3 Write fault. ee ee 
P ) 4 Drive not ready. 29 or 157 | Alternate track to be formatted 
5 Drive not selected. is either a bad track or already 
6 No track 0. an alternate. 
7 legal or multiple drives 30 or 158 Hel case gl ae 
selected. 
10 Insufficient capacity. 31 or 159 Alternate track to be formatted 
16 1D CRC error. is is batt track as the bad 
AZ Data CRC error. Hace dSeM, 
18 1D address mark not found. 32 or 160 Invalid command from disk 
19 Data address mark not found. a eras shee qaeaaa 
20 t Record not found. me See 
D4 hevamaner 48 or 176 | RAM diagnostic failure. 
29 DMA timeout error 149 0r177 | Program memory checksum 
23 Write-protected. Se. 5 te 
95 Bad plocieiouad. 50 or 178 | ECC diagnostic failure. 
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ERROR CODES 


Disk System Context Errors 


For some file system errors, a supplemental error message 
may be displayed. This supplemental message describes 
the type of error which has occurred. Table A-2 explains 
these context error messages: 


Table A-2 
DISK SYSTEM CONTEXT ERRORS 


Error Explanation 
~ Disk Full There is no more room to write dataon | 
the specified disk. 
Drive Not Ready There is no disk in the specified drive, or 
the door is open. 
Write Protected The disk to which you are trying to write 


can only be read at this time. 


Invalid Device Specifier | The device you specified is not valid for 


this command. 


File Not Found The terminal cannot find the specified 


file on the specified device. 


Directory Full The disk already contains the maximum 


number of files permitted. 


File Full There is no more room to write data in 


_ the specified file. 


File Currently Being Trying to access a file that is currently 
Written being written to. 


Invalid Media Format The disk in the specified device is 


formatted with an unsupported format. 


Device Busy The specified device is currently active 


and therefore cannot be accessed. 


Invalid File Specifier You specified a device and filename 


when only a filename is valid. 


File Busy Trying to protect or rename a file that is 


currently being written to or read. 


File Already Exists You are trying to rename a file to aname 


that already exists. 
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3PP! Hardware Errors 


For the Three Port Peripheral Interface option (Option 10), 
the terminal reports hardware errors in this format: 


> > Terminal Detects Error xxn9 
>> Port Hardware Error Type yy, Parameter n. 


In the first line, xx refers to the command (with the two-letter 
error code). The 7 in both lines refers to the number of the 
parameter that caused the error. Yy refers to the error num- 
ber listed in Table A-3. 


Table A-3 
3PPI HARDWARE ERRORS 


Error 

Number Explanation 

33 3PPI: Circular buffer overrun. 
34 3PPI: 8250 data overrun. 
35 3PPI: Errors 33 and 34. 

36 3PPI: 8250 parity error. 

37 3PPI: Errors 33 and 36. 

38 3PPI: Errors 34 and 36. 

39 3PPI: Errors 33, 34, and 36. 
40 3PPI: 8250 framing error. 
41 3PPI: Errors 33 and 40. 

42 3PPI: Errors 34 and 40. 

43 3PPI: Errors 33, 34, and 40. 
44 3PP]: Errors 36 and 40. 

45 3PPI: Errors 33, 36, and 40. 
46 3PPI: Errors 34, 36, and 40. 


: Errors 33, 34, 36, and 40. 
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DMA Transfer Errors 


Divi: Device Errors. When DM: Is specified as a device (with 
Option 3A: DMA Interface installed), there are error mes- 
sages that may be reported if certain errors are generated 
(instead of the standard “Terminal detects...’’). These error 
messages are: 


“DMA Option 3A There is not enough memory availa- 

failed to power up” ble to satisfy the requirements for 
DM: use. 

“Invalid DMA The parameter portion of the 

Parameter” DM:parameter device is invalid. 


Also, for some file system errors (‘‘type 9” errors such as 
JCO9, JC39, JD39, etc.), a supplemental error message is 
displayed when an error is generated by a transfer involving 
the DMA. This supplemental message describes the type of 
error which has occurred. Table A-4 lists these errors: 


Table A-4 
DiVIA TRANSFER ERRORS 
Error Explanation 
Host not ready for DMA | The host computer is not ready to start a 
transfer DMA transfer (as indicated by the 


READY line of the DR11B board). 


Host aborted DMA 
transfer code to the terminal (via the FNCT 


lines). 


DMA transfer failed The host computer tried to transfer more 
data in a block than was specified in the 
last SET-DMA-BLOCK-SIZE command 
OR the host tried to initiate a block 
transfer before the end of the last 


terminal-to-host DMA block transfer. 


Host termination signal | The signals sent by the host at the end 
invalid of a DMA block transfer are invalid. 
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The host computer has sent an ABORT 
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ERROR CODES 


Pseudo Devices. When the DMA pseudo devices are speci- 
fied as devices, there are error messages that may be 
reported if certain errors are generated (instead of the 
standard “Terminal detects...’’). These error messages are: 


“DMA Option 3A There is not enough memory availa- 
Pseudo Devices failed ble to satisfy the requirements for 
to power up” DMA pseudo device use. 


“Invalid Pseudo 
Device Parameter” 


The parameter portion of the 
pseudo device specifier is invalid. 


There is an error in the data 
received from the host computer by 
a DS: or SG: pseudo device. 


“Data Format Error” 


ERROR CODES 


TEK ERROR CODES IE 
%!  SELECT-CODE = £c%! int on 
%!00 (Level 0): Unrecognized command; terminal firm- E00 
ware is Version 3. 
%!11 (Level 2): Invalid command-set (must be 0 or 1.) 
10 (For several GIN commands.) IEO3 
l002 = (Level 2): Insufficient memory available for GIN 
functions. (Only detected at power-up or 
during a RESET.) 
1E1 
1011 (Level 2): Invalid device-function code. (See the gies 
description of the ENABLE-GIN com- 
mand for a table of device-function IE13 
codes.) 
1E21 
1 ENABLE-4953-TABLET-GIN 
DISABLE-4953-TABLET-GIN = c! char 
1100 =©(Level 0): Unrecognized command (Option 13 or 14 IF 
lled). 
not installed) 1014 
IA SET-PICK-APERTURE = clA int 
1A11 (Level 2): Invalid aperture-width (must range from 0 IFOO 
to 4095). 
IF10 
IC SET-GIN-CURSOR = SclC int int 
1011 (Level 2): Invalid device-function code. (See the 
description of the ENABLE-GIN com- IF21 
mand for a table of device-function 1F34 
codes.) 
IC13 (Level 2): Graphic input has already been enabled IG 
for the specified device-function code. 
IC20 (Level 2): Segment does not exist, or is currently oe 
being defined. 
IC21 (Level 2): Invalid segment-number (must range from IG 
0 to 32767). 10 
l - = FolDi 
D DISABLE-GIN cID int G24 
1011. (Level 2): Invalid device-function code. 
IG31 
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ENABLE-GIN = ‘clE int int 
(Level 2): Invalid device-function code. 


(Level 2): The cursor segment for the specified 
device-function code does not exist. (It 
has been deleted after the SET-GIN- 
CURSOR command which assigned it to 
that device-function code.) 


(Level 2): Command is invalid at this time. (The 
segment being used as the cursor for the 
specified device-function code is a seg- 
ment which is currently being defined.) 


(Level 2): The specified GIN device is not installed 
in the terminal. 


(Level 2): The specified GIN device is already 
enabled. 


(Level 2): Invalid number-of-GIN-events. (Must 
; range from 0 to 65535.) 


SET-GIN-STROKE-FILTERING = -cIF int int int 


(Level 2): Invalid device-function code. (See the 
table with the ENABLE-GIN command for 
valid device-function codes.) 


(Level 0): Unrecognized command. (The tablet 
option is not installed.) 


(Level 2): Stroke filtering is not valid for the speci- 
fied device-function code. (Only allowed 
for stroke function.) 


(Level 2): Invalid distance-filter (range is 0 to 4095). 
(Level 2): Invalid time-filter (range is 0 to 32767). 


SET-GIN-GRIDDING = clG int int int 


(Level 2): Invalid device-function code. (See the 
table with the ENABLE-GIN command for 
valid device-function codes.) 


(Level 2): Gridding does not apply to the specified 
device-function code. (Gridding is not 
allowed for the stroke function.) 

(Level 2): Invalid x-grid-spacing (4112, 4113, 4114, 
4116: 0 to 4095; 4115: —23' to 23'—1). 

(Level 2): Invalid y-grid-spacing (4112, 4113, 4114, 
4116: 0 to 4095; 4115: —23' to 231-1). 
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10 


IN41 


1E10 


[E13 


IPi3 
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SET-TABLET-HEADER-CHARACTERS = clH int 


(Level 0): Unrecognized command. (Tablet option is 
not installed.) 


(Level 2): Invalid character-set-selector. (Must be 0 
or 1; in Setup mode, must be CONTROL 
or LETTERS.) 


SET-GIN-INKING = cil int int 


(Level 2): Invalid device-function code. (See the 
description of the ENABLE-GIN com- 
mand for a table of device-function 
codes.) 


(Level 2): Inking does not apply to the specified 
device-function code. (Inking is not 
allowed for the pick function.) 


(Level 2): Invalid inking mode (must be QO, 1 or 2). 


SET-REPORT-MAX-LINE-LENGTH = ‘ciL int 


(Level 2): Invalid max-line-length. (Must range from 
0 to 65535.) 


SET-REPORT-EOM-FREQUENCY = ‘cli ini 


(Level 2): Invalid EOM-frequency setting (must be 0 
or 1). 


SET-TABLET-SIZE = ciN int 


(Level 2): Unrecognized command. (Requires ver- 
sion 2 or later of Option 13 or 14 firm- 
ware.) 


(Level 2): Invalid tablet-size-mode. (Must be 0, 1, 
or 2.) 


REPORT-GIN-POINT =  ciP int 


(Level 2): tnvalid device-function code. (See the 
description of the ENABLE-GIN com- 
mand for a list of valid device-function 
codes.) 


(Level 2): The specified GIN device is not installed 
in the terminal. 


(Level 2): A plotter device is not assigned to the 
specified port. 


(Level 2): The device-function code names a device 
which has already been enabled for a 
different graphic input function. 


IQ 


IR10 


[R21 


IV03 


IV21 


IV31 


V4 
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ERROR CODES 


REPORT-TERMINAL-SETTINGS = clQ char char 


No errors are detected for this command. 


SET-GIN-RUBBERBANDING = €cIR int int 


(Level 2): Invalid device-function code. (See the 
ENABLE-GIN command for a table of 
device-function codes.) 


(Level 2): Rubberbanding does not apply to the 
specified device-function code. (Rubber- 
banding is only allowed for the locator 
function. It is not allowed for the pick and 
stroke functions.) 


(Level 2): Invalid rubberbanding mode (must be O, 
1, or 2). 


SET-REPORT-SIG-CHARS = clS int int int 


(Level 2): Invalid report-type-code. (Must be a valid 
device-function code, or from —1 to —-3.) 


(Level 2): Invalid sig-char. (Must range from 0 to 
127). 


(Level 2): Invalid term-sig-char. (Must range from 0 
to 127.) 


SET-TABLET-STATUS-STRAP = €clT int 


(Level 0): Unrecognized command. (The tablet 
option is not installed.) 


(Level 2): Invalid strap-setting (must be O or 1). 


SET-GIN-AREA = FclV int int xy xy 


(Level 2): Invalid device-function (see ENABLE- 
GIN). 


(Level 0): Unrecognized command; terminal firm- 
ware Is Version 3 or earlier. 


(Level 3): Out of memory while processing com- 
mand. 


(Level 2): Invalid window-specifier (range is —1 to 
64). 

(Level 2): Invalid frrst-corner (X or Y out of range O 
to 4095). 


(Level 2): Invalid second-corner (X or Y out of range 
0 to 4095, or area is of zero widih or 
height). 


# we) 
&A i 


ERROR CODES 


IW 

IWOO (Level 0): 
IWi1 (Level 2): 
IW21 (Level 2): 
IX 

1011 (Level 2): 
IXO0O = (Level 0): 
IX21 (Level 2): 
JO and J1: 

J002 (Level 3): 
J102 (Level 3): 
J109 (Level 3): 
JB 

JBOO (Level 0): 
JBO3 (Level 2): 
JB10 (Level 2): 
JB1i1 (Level 2): 
JB12 (Level 3): 
JB13 (Level 2): 
JB19 (Level 2): 


SET-GIN-WINDOW =  cIW xy xy 


Unrecognized command; terminal firm- 
ware is Version 3 or earlier. 


Invalid first-corner (X or Y out of range 
—231 to 231-1), 


Invalid second-corner (X or Y out of range 
—23' to 2311). 


SET-GIN-DISPLAY-START-POINT =  clX int xy 


Invalid device-function parameter. (See 
ENABLE-GIN for a table of valid device- 
function codes.) 


invalid command; firmware is Version 3 or 
earlier. 


Invalid start-point (4112, 4113, 4114, 
4116: X = 0 to 4095, Y = Oto 4095; 
4115: X = -23' to 231-1, Y = —23' to 
231-1). 


Disk System Errors on Power-Up 


Memory error detected by standard firm- 
ware. 


Memory error detected by optional 
peripheral firmware. 


Hardware initialization error in option 
controller board. 


ACTIVATE-LPOS = -cJB 


Unrecognized command (Option 
42/43/45 or Version 6 or higher not 
installed). 


A filename was specified when LPOS was 
resident in terminal memory, or a filename 
was not specified, but LPOS was active. 


The boot-file was not found. 
Illegal filename. 


Out of memory while performing com- 
mand. 


Context error (local programmability 
already active). 


Disk hardware error (drive not ready, I/O 
error). 


JC 
JCO1 
JC02 


JCO3 


JC10 


JC11 
JC12 


JC13 


JC19 


JC20 


JC21 


JC22 


JC30 


JC31 
JC32 


JC33 


JC39 
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COPY = FcJC device string device 


(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


Data format error (Options 3A and 9 only). 


Out of memory while attempting DMA 
transfer (Option 3A only). 


Attempt to copy an entire disk volume 
onto itself (e.g., a copy from FO: to F0:). 


Specified source device is not installed, or 
file does not exist. 


Invalid source specifier. 


Out of memory while parsing the parame- 
ter, or while executing the command. 


Parameter 1 context error (not an input 
device, or device is busy). 


Disk hardware error or drive not ready on 
the source device, or error in DMA block 
transfer. 


Separator parameter missing. 


Invalid separator (must be empty string or 
TO; in Setup mode, must be TO). 


Out of memory while parsing the 
parameter. 


Specified destination device is not 
installed. 


Invalid destination specifier. 


Out of memory while parsing the parame- 
ter, or while executing the command. 


Parameter 3 context error. (Invalid desti- 
nation device, device is busy or full, or 
existing disk file is write protected.) 


Disk hardware error or drive not ready on 
the destination device, or error in DMA 
block transfer. 
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JD 
JDOO 


JD10 


JD11 
JD12 


JD13 


JD19 


JD20 


JD21 


JD22 


JD30 


JD31 
JD32 


JD33 


JD39 
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DIRECTORY = FcJD device string device 


(Level 2): 


(Level 2): 


(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


Unrecognized command. (Disk drive 
option is not installed.) 


The specified source device is not 
installed or file does not exist. 


Invalid source specifier. 


Out of memory while parsing the parame- 
ter, or while executing the command. 


Context error in parameter 1. (The speci- 
fied device is not a disk drive, or failed 
reading bit map.) 


Disk hardware error (or drive not ready) 
for the disk drive whose directory is being 
requested. 


Separator parameter missing. 


Invalid separator (must be empty string or 
TO). 

Out of memory while parsing the parame- 
ter. 


The specified destination device is not 
installed. 


Invalid destination specifier. 


Out of memory while parsing the parame- 
ter, or while executing the command. 


Parameter 3 context error. (The device 
specified is not a valid destination device, 
the disk ts full, or the file is write- 
protected.) 


Hardware error for the destination device. 


(I/O error, write-protect error, disk drive 
not ready, or DMA block transfer error.) 


JE 


JF 
JFOO 


JF10 
JFi1 
JFi12 


JF13 


JF19 


JH 
JHOO 


JHO3 


JH11 


JJ 
JJOO 


JJ10 
JJ11 
JJ13 
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ERROR CODES 


STOP-SPOOLING = FcJE 


No errors are detected for this command. 


FORMAT-VOLUME = FcJF device 


(Level 2): 


(Level 2): 
(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


Unrecognized command. (Disk drive 
option not installed.) 


Device is not installed. 
Invalid device specifier. 


Out of memory while parsing the parame- 
ter. 


The device specified is not a disk drive, is 
write-protected, is busy, detects a verify 
error, detects a bit map error, or is not 
mounted. 


Hardware error at the specified disk drive. 
(Format error, drive not ready, or write- 
protect switch or notch error.) 


SET-DMA-BLOCK-SIZE = FcJH int 


(Level 0): 


(Level 2): 


(Level 2): 


Unrecognized command (Option 3A is not 
installed.) 


Command received after DMA failed to 
power up. 


Invalid parameter (must be from 1 to 
65504). 


DISMOUNT = fcJJ device 


(Level 0): Unrecognized command; firmware is 
Version 3 or earlier, or there are no disk 
options installed. 

(Level 2): The device is not installed. 

(Level 2): Invalid device parameter. 

(Level 2): Parameter 1 context error (not a valid 


device, or device is busy). 
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JK 
JKOO 


JK10 


JK11 
JK12 
JK13 


JK19 


JL 


JLO2 


JLOS3 


JL10 
JL11 
JL12 


JL13 


JL19 


JP 
JPOO 


JP10 


JP11 
JP12 
JP13 


JP19 


JP21 
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DELETE-FILE = -cJK device 


(Level 2): Unrecognized command. (Disk drive 
option is not installed.) 


(Level 2): The specified file does not exist or device 
is not installed. 


(Level 2): Invalid file-specifier. 
(Level 3): Out of memory while parsing parameter. 


(Level 2): The specified device is not a disk drive, is 
write-protected, is busy, or detects a bit 
map error. 


(Level 2): Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 


LOAD = cJL device 


(Level 3): Out of memory while performing LOAD 
command. 


(Level 2): Nesting error. (LOAD commands are 
nested too deeply.) 


(Level 2): File or device does not exist. 
(Level 2): Invalid source specifier. 


(Level 3): Out of memory while parsing parameter, 
or while executing the command. 


(Level 2): Context error in parameter 1. (Not a valid 
source device, device is busy, or com- 
mand detects a disk format error.) 


(Level 2): Device hardware error (disk hardware 
error, drive not ready, or DMA block trans- 
fer error). 


PROTECT-FILE = -cJP device int 


(Level 2): Unrecognized command. (Disk drive 


option is not installed.) 


(Level 2): The specified file or disk drive does not 


exist. 
(Level 2): 
(Level 3): 
(Level 2): 


Invalid file specifier. 
Out of memory while parsing parameter. 


Either the specified device is not a disk 
drive, or the file (or entire diskette volume) 
has been write-protected. 


(Level 2): Disk hardware error. (I/O error, drive not 


ready, or hardware write-protect error.) 


(Level 2): Invalid write-protect-mode (must be 


O or 1). 


JQ 

JQ10 
JQ11 
JQ12 


JR 
JROO 


JR10 
JR11 
JR12 
JR13 


JR19 


JR20 
JR21 


JR22 
JR30 


JR31 
JR32 
JR33 


JR39 
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REPORT-DEVICE-STATUS = cJQ device 


(Level 2): 
(Level 2): 
(Level 3): 


Device is not installed. 
Invalid device specifier. 


Out of memory while parsing parameter. 


RENAME-FILE =  cJR device string device 


(Level 2): 


(Level 2): 
(Level 2): 
(Level 3): 
(Level 2): 


(Level 2): 


(Level 2): 
(Level 2): 


(Level 3): 
(Level 2): 


(Level 2): 
(Level 3): 
(Level 2): 


(Level 2): 


Unrecognized command. (Disk drive 
option is not installed.) 


The specified device or file does not exist. 
Invalid old-filename specifier. 
Out of memory while parsing parameter. 


Parameter 1 context error (file is write- 
protected, device is busy, or command 
detects invalid disk format). 


Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 


Separator parameter is missing. 


Invalid separator (must be empty string or 
TO). 


Out of memory while parsing parameter. 


Either the device specified in parameter 3 
does not exist, or is different from the 
device specified in parameter 1, or new- 
filename already exists. 


Invalid new-filename specifier. 
Out of memory while parsing parameter. 


Parameter 3 context error (invalid device 
specifier). 


Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 
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JS SPOOL = cJS device string device 

JSO1 (Level 2): Data format error (Options 3A and 9 only). 

JSO2 (Level 3): Out of memory while attempting DMA 
transfer (Option 3A only). 

JSO3 (Level 2): Command context error. (A spooling 
operation is already In progress.) 

JS10 (Level 2): Specified source does not exist. 

JS11 (Level 2): Invalid source specifier. 

JS12 (Level 3): Out of memory while parsing parameter, 
or while executing the command. 

JS13 (Level 2): Parameter 1 context error. (Not a valid 
source device, or device is busy.) 

JS19 (Level 2): Device hardware error (disk hardware 
error, drive not ready, or DMA block trans- 
fer error). 

JS20 (Level 2): Separator parameter is missing. 

JS21 (Level 2): Invalid separator (must be empty string or 
TO). 

JS22 (Level 3): Out of memory while parsing parameter. 

JS30 (Level 2): Specified destination does not exist. 

JS31 (Level 1): Invalid destination device specifier. 

JS32 (Level 3): Out of memory while parsing parameter, 
or while executing the command. 

JS33 (Level 2): Parameter 3 context error. (Not a valid 
destination, device is busy, or existing file 
is write protected or open.) 

JS39 (Level 2): Device hardware error (disk hardware 
error, drive not ready, or DMA block trans- 
fer error). 
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JU 


JUOO0 


JU11 


JV 
JV02 


JV01 


JV11 


JV12 


JV20 


JV24 
JV31 


JV32 


JV40 
JV41 
JV42 


JV43 


JV49 
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ERROR CODES 


SET-USER-NUMBER = cJU int 


(Level 0): 


(Level 2): 


Unrecognized command (firmware is 
Version 3 or earlier or disk option Is not 
installed). 


Invalid wser-number (must be O to 15). 


SAVE = FcJV string int string device 


(Level 3): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


(Level 2): 
(Level 2): 


(Level 3): 


(Level 2): 
(Level 2): 
(Level 2): 


(Level 2): 


(Level 2): 


Out of memory while attempting DMA 
transfer (Option 3A only). 


RAS and RUN are valid for raster termi- 
nals only. 


Invalid thing-to-be-saved. (Must be MAC, 
SEG, RAS, or RUN. The latter two codes 
are valid for 4112, 4113, and 4115 termi- 
nals only.) 


Out of memory while parsing parameter, 
or while executing the command. 


The specified macro or segment does not 
exist, or segment is being defined. 


Invalid item-number-or-count. 


Invalid separator (must be empty string or 
TO). 

Out of memory while parsing the 
parameter. 

The specified destination is not installed. 


Invalid destination specifier. 


Out of memory while parsing the parame- 
ter, or while executing the command. 


Not a valid destination device, device is 
busy, or existing disk file is write protected 
Or open. 


Device hardware error. (I/O error, drive not 
ready, hardware write-protect error, or 
DMA block transfer error.) 


SET-MARGINS = ©cKM int 


(Level 0): Unrecognized command. (The terminal is 
not a 4114 or 4116.) 


(Level 2): Invalid number-of-margins (must be from 
1 to 8). 


RENEW-VIEW = ©cKN int 


(Level 3): Out of memory while attempting to renew 
a view. (This error can also occur asa 
result of pressing the PAGE key.)(4112, 
4113, and 4115 only.) 


(Level 2): 
(Level 2): 


The view specified does not exist. 


Parameter out of range (must range from 
—32768 to 32767). 


SET-PAGE-FULL-ACTION = &cKP int 
(Level 2): Invalid page-full-action. (Must range from 


0 to 7.) 


REPORT-ERRORS = -cKQ 


No errors are detected for this command. 


CRLF = ‘cKR int 
(Level 2): Invalid CRLF-mode (must be 0 or 1). 


SET-SNOOPY-MODE =  cKS int 

(Level 2): Invalid stoopy-mode (must be 0 or 1) 
SET-ERROR-THRESHOLD = £cKT int 

(Level 2): Invalid error-threshold-level (must be from 


0 to 4). 


RESET = -cKV 


No errors are detected for this command. 


KO: Keyboard System Errors - KM 
KOO2 (Level 3): Out of memory while initializing the key- KMOO 
board system. | 
| KM11 
KA ENABLE-DIALOG-AREA = FcKA int 
KAi1 (Level 2): Invalid enable-mode (must be 0 or 1). 
| KN 
KC CANCEL = -FcKC KNO2 
No errors are detected for this command. 
KD DEFINE-MACRO = £cKD int int-array KNiO 
KDi1 (Level 2): Invalid macro number (must be in range KN44 
—32768 to —32742, -32740 to —32737, 
-—32608 to -32513, or -1 to 32767). 
KD21 (Level 2): Invalid int-array (length must be from 0 to KP 
65535, int values must be from 0 to 127). 
KD22 (Level 3): Insufficient memory to define macro. Ae 
KE SET-ECHO =  cKE int KO 
KE11 (Level 2): Invalid echo-mode (must be 0 or 1). 
KF LFCR = ©cKF int KR 
KF11 (Level 2): Invalid LFCR-mode (must be 0 or 1). KR14 
KH HARDCOPY = cKH int KS 
KHO1 (Level 2): Copier fault condition; operator assist- KS11 
ance required (Option 9 only). 
KH11 (Level 2): Invalid hard-copy-code (must be 0, 1, or KT 
2). 
KT 11 
KI IGNORE-DELETES = cKl int 
Kl11 (Level 2): Invalid ignore-deletes mode (must be KV 
Oor 1). 
KL LOCK-KEYBOARD = ‘cKL int 
KL11 (Level 2): Invalid keyboard-lock-mode (must be 


Oor 1). 
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KX 
KX11 


KY 
KY 11 


KZ 


KZ11 


KZ2 4 


KZ31 


LB 
LB11 


LC 
LC11 


LE 


LEOO 


LEO3 


LEO2 


LF 
LF11 


LG 
LG11 


4115B OPERATORS 


EXPAND-MACRO = ‘ckKX int 


(Level 2): Invalid #2acro-number (must be from 
—32768 to -32742, -32740 to —32737, 
—32608 to -32513, or 0 to 32767). 


SET-KEY-EXECUTE-CHAR = ckKyY int 


(Level 2): Invalid key-execute-char (must range from 
Oto 127). 


SET-EDIT-CHARS = ckKZ int int int 


(Level 2): Invalid char-delete character (must range 


from 0 to 127). 


(Level 2): Invalid /ine-delete character (must range 


from 0 to 127). 


(Level 2): Invalid take-literally character (must 


range from 0 to 127). 


SET-DIALOG-AREA-BUFFER-SIZE = *cLB int 


(Level 2): Invalid nuimber-of-lines. (Must range from 
2 to 32767.) 


SET-DIALOG-AREA-CHARS = cLC int 


(Level 2): Invalid number-of-chars. (4112, 4113: 5 to 
80; 4114, 4116: 5 to 819; 4115: 5 to 160.) 


END-PANEL = FcLE 


(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115). 


(Level 1): No panel is currently being defined. 


(Level 3): Out of memory while performing END- 
PANEL command. 


MOVE = EcLF xy 


(Level 2): Invalid position (4112, 4113, 4114, 4116: 
X = 0to 4095, Y = Oto 4095; 4115: K = 
0 to 4095 or —2°' to 23'-1, Y = Oto 4095 
or —23' to 23'-1,) 


DRAW = cLG xy 


(Level 2): Invalid position (4112, 4113, 4114, 4116: 
X = 0t0 4095, Y = Oto 4095; 4115: K = 
0 to 4095 or —2°' to 23'-1, Y = 0 to 4095 
or —29' to 231-1.) 


LH 
Cet 


LI 
LIOO 


Llit 


LI21 


LI31 


LJ 


LJOO 


LJ114 


Lik 


LKO2 


LK10 


LK114 


LK13 


LL 
LL11 


LM 
LM 1 1 
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ERROR CODES 


DRAW-MARKER = FcLH xy 


(Level 2): Invalid position (4112, 4113, 4114, 4116: 
xX = Oto 4095, Y = Oto 4095; 4115: X = 
0 to 4095 or —2?' to 23'-1, Y = Oto 4095 
or —23' to 23'-1.) 


SET-DIALOG-AREA-INDEX = cL int int int 


(Level 0): Unrecognized command. (The terminal is 


not a 4112, 4113, or 4115.) 


Invalid character-index. (Range is 0 to 
32767.) 


(Level 2): 


Invalid character-background-index. 
(Range is 0 to 32767.) 


(Level 2): 


(Level 2): Invalid wipe-index. (Range is 0 to 32767.) 


SET-DIALOG-AREA-ALTERNATE-INDEX = FclJ int 


(Level 0): Unrecognized command (terminal is not 


Version 4 or later; only valid for 4112, 
4113, or 4115). 


(Level 2): Invalid index (range is 0 to 65535). 


INCLUDE-COPY-OF-SEGMENT = cL int 


(Level 3): Out of memory while performing 
INCLUDE-COPY-OF-SEGMENT. (4112, 
4413 and 4115 only). 


(Level 2): 
(Level 2): 


Segment does not exist. 


Invalid segment-number (must be —3, —1, 
or from 1 to 32767.) 


(Level 2): The segment specified is currently being 


defined. 


SET-DIALOG-AREA-LINES = cLL int 


(Level 2): Invalid number-of-lines. (4112, 4113: 2 to 
34: 4114, 4116: 2 to 520; 4115: 2 to 64.) 


SET-DIALOG-AREA-WRITING-MODE = fcLM int 


(Level 2): Invalid writing-mode (must be 0 or 1). 


ERROR CODES 


LP 
LPOO 


LPO2 
LPO3 


LP11 


LP21 


LS 


LSOO 


LS11 


LT 


LTO3 


LT11 


LT12 


LV 


LVO3 


LV11 


LX 
LX11 
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BEGIN-PANEL-BOUNDARY =  cLP xy int 


(Level 0): Unrecognized command. (Terminal is not 
a 4112, 4113, ora 4115.) 


(Level 3): 
(Level 2): 


Out of memory while defining panel. 


Alphatext is not allowed within a panel- 
definition. When this error is detected, 
the panel being defined is closed, as if an 
END-PANEL command had been 
received. 


Invalid first-point (4112, 4113: X = Oto 
4095, Y = Oto 4095; 4115: X = 0 to 4095 
or —2°' to 23'-1, Y = 0 to 4095 or —2°' to 
231_1), 


(Level 2): 


(Level 2): Invalid draw-boundary-mode (must be 0 


or 1). 


SET-DIALOG-AREA-SURFACE = ®cLS int 


(Level 0): Unrecognized command. (The terminal is 


not a 4112, 4113, or 4115.) 


(Level 2): Invalid surface-number. (4112: 1 to 3; 


4113: 1 to 4; 4115: 1 to 8.) 


GRAPHIC-TEXT = cLT string 


(Level 2): Command is invalid at this time 
(graphtext is not allowed within a panel- 
definition). 


(Level 2): Invalid array count (must be from 0 to 
65535). 


(Level 2): Out of memory while parsing the 
parameter. 


SET-DIALOG-AREA-VISIBILITY = cLV int 


(Level 0): One or more of the dialog area parame- 
ters was altered when the dialog area was 


made visible. 


(Level 2): Invalid visibility-mode. (Must be 0 or 1.) 


SET-DIALOG-AREA-POSITION =  cLX xy 


(Level 2): Invalid position (4115: X or Y out of range 
0 to 4095). 


LZ 


CLEAR-DIALOG-SCROLL = FcLZ 


No errors are detected for this command. 


MA 
MAOO 


MA1 1 


MB 


MBOO 


MB11 


MB21 


MC 


MC11 


MC21 


MC31 


MD 


MDOO 


MDO02 


MDO03 


MD11 


MD21 


MD31 


| MD41 
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SET-GRAPHTEXT-SLANT = cMA real 


(Level 0): Unrecognized command; firmware is 
Version 3 or earlier. 


(Level 2): Invalid slant-angle (must range from 
—32767.0 to 32767.0). 


SET-BACKGROUND-INDICES = £cMB int int 


(Level 0): Unrecognized command. (The terminal is 


nota 4112, 4113, or 4115). 


(Level 2): Invalid text-background-index (must 


range from —2 to 32767). 


(Level 2): Invalid dash-gap-index (must range from 


~2 to 32767). 


SET-GRAPHTEXT-SIZE = -cMC int int int 


(Level 2): Invalid value in parameter 1. (4112, 4113, 
4114, 4116: 1 to 4095; 4115: 1 to 2°'-1.) 


(Level 2): Invalid value in parameter 2. (4112, 4113, 
4114, 4116: 1 to 4095; 4115: 1 to 2°'-1,) 


(Level 2): Invalid value in parameter 3. (4112, 4113, 
4114, 4116: 0 to 4095; 4115: 0 to 2°'-1.) 


BEGIN-FILL-PATTERN = ©cMD int int int int 


(Level 0): Unrecognized command. (The terminal is 


not a 4112, 4113, or 4115.) 


(Level 3): Not enough memory available for fill 


pattern. 


(Level 2): Another fill pattern is currently being 


defined. 


Invalid Jill-pattern-number (must range 
from 1 to 32767). 


Invalid pattern-width (4112, 4113: 1 to 32; 
4115: 1 to 1280). 


(Level 2): 


(Level 2): 


(Level 2): Invalid pattern-height (4112, 4113: 0 to 


480; 4115: 0 to 1024). 


(Level 2): Invalid bits-per-pixel (on the 4112, must 
be 1, 2, 3, or 6; on the 4113, must be 1, 2, 


3, 4, or 6; on the 4115, must be 1 to 8). 


4115B OPERATORS 


ME 
MEOO 


MIF 
MF 10 
MFi1 


MG 


MGOO 


MG11 


vil 
M103 


Mii 1 


MIL 
ML11 


VIM 
MM 14 


MP 


MPOO 


MP 10 


MP1 1 


MQ 
MQ11 
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END-FILL-PATTERN = -FcME 


(Level 2): Unrecognized command. (Terminal is not 
a 4112, 4113, or 4115). 


SET-GRAPHTEXT-FONT =  cMF int 
(Level 2): Font is not defined. 


(Level 2): Invalid font-number (must range from 0 to 
32767). 


SET-GRAPHICS-AREA-WRITING-MODE = -cMG int 


(Level 0): Unrecognized command. (Terminal is not 
a 4112, 4113, or 4115.) 


(Level 2): Invalid writing-mode. (Must be 0 or 1.) 


SET-PICK-ID = -cMlint 


(Level 2): Command is invalid at this time. (No seg- 
ment is currently being defined.) 


(Level 2): Invalid pick-number. (Must range from 0 
to 32767.) 


SET-LINE-INDEX = -cML int 


(Level 2): Invalid /ine-index. (Must range from 0 to 
32767.) 


SET-MARKER-TYPE =  ciiM int 


(Level 2): Invalid marker-number (must be from 
O to 10). 


SELECT-FILL-PATTERN = cP int 


(Level 2): Unrecognized command. (The terminal is 


not a4112, 4113, or 4115.) 


(Level 2): Specified fill-pattern has not been 


defined. 


(Level 2): Invalid fi//-pattern (must range from 


32768 to 32767.) 


SET-GRAPHTEXT-PRECISION = -cMQ int 


(Level 2): Invalid precision mode (must be 1 or 2). 


VIR 
MR1 14 


MS 


MS0O 


MS11 


MS21 


MS31 


MT 
M111 


MIV 


MV 11 


MV 
MW00 


MW 114 


MY 
MY0OO 


MY 14 


MZ 
MZOO 


M211 


M221 


MZ31 
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ERROR CODES 


SET-GRAPHTEXT-ROTATION = -cMR real 


(Level 2): Invalid angle-in-degrees (must range from 
—32767.0 to 32767.0). 


SET-PANEL-FILLING-MODE =  cMS int int int 


Unrecognized command. (Terminal ts not 
a 4112, 4113, or 4115.) 


(Level 0): 


(Level 2): Invalid overstrike/replace mode (must be 


Oor 1). 


Invalid cover-boundary mode (must be 0 
or 1). 


(Level 2): 


(Level 2): Invalid pattern-keying-mode (must be 


from O to 3). 


SET-TEXT-INDEX = -cMT int 


(Level 2): Invalid text-index. (Must range from 0 to 
65535.) 


SET-LINE-STYLE = FcMV int 


(Level 2): Invalid /ine-style. (Must range from 0 to 7.) 


SET-LINE-WIDTH = -cMW int 


(Level 0): Unrecognized commana. (The terminal is 
nota 4114 or 4116.) 


(Level 2): Invalid width. (Must be 0 or 1.) 


SELECT-ALPHATEXT-SIZE-GROUP = .cMY int 


(Level 0): Unrecognized command (terminal is not a 
4114 or 4116). 


(Level 2): Invalid group (must be either 0 or 1). 


SET-ALPHATEXT-SIZE = -cMZ int int int 


(Level 0): Unrecognized command. (Terminal is not 


a4114 0r 4116.) 


(Level 2): Invalid size-multiplier (must range from 1 


to 16). 


(Level 2): Invalid inter-character-spacing (must 


range from 0 to 15). 


(Level 2): Invalid interline-spacing (must range from 


0 to 255). 


ERROR CODES 


NB 
NB11 


NC 


NC11 


NC21 


ND 
ND11 


NE 
NE11 


NE12 


NF 
NF11 


NK 
NK11 


NL 
NL11 


NM 


NM11 


NP 
NP 11 


(Level 3): 


SET-STOP-BITS = -cNB int 


(Level 2): Invalid number-of-stop-bits (must be 1 or 
2). 


SET-EOM-CHARS = €cNC int int 


(Level 2): Invalid EOM-char-J. (Must range from 0 
to 127.) 


(Level 2): Invalid EOM-char-2. (Must range from 0 
to 127.) 


SET-TRANSMIT-DELAY = cND int 


(Level 2): Invalid transmit-delay. (Must range from 0 
to 65535.) 


SET-EOF-STRING =  cNE int-array 


(Level 2): Invalid EOF-string (must contain from 
0 to 10 characters, with each character 
represented by an int in the range from 
0 to 127). 


Out of memory while parsing the 
parameter. 


SET-FLAGGING-MODE = €cNF int 


(Level 2): Invalid flagging-mode (must be from 
0 to 4). 


SET-BREAK-TIME = -cNK int 


(Level 2): Invalid parameter. (Must range from 0 to 
65535.) 


SET-TRANSMIT-RATE-LIMIT =  cNL int 


(Level 2): Invalid rate-/imit. (Must range from 110 to 
65535.) 


PROMPT-MODE = ‘cNM int 


(Level 2): Invalid prompt-mode (must be 0, 1,or 2). 


SET-PARITY = -cNP int 
(Level 2): Invalid parity-mode. (Must be from 0 to 4.) 


NQ 
NQ01 
NQO02 


NQi1 


NR 
NR11 


NR21 


NS 
NS11 


NS12 


NT 
NT11 


NT12 


NU 
NU11 


OB 
OBOO 


OBO3 


OB11 
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SET-QUEUE-SIZE = cNQ int 
(Level 3): 
(Level 3): 


Not all memory freed from queue. 


Out of memory while performing SET- 
QUEUE-SIZE command. 


(Level 2): Invalid queue-size. (Must range from 1 to 


65535.) 


SET-BAUD-RATES = ©cNR int int 


(Level 2): Invalid transmit-data-rate. (Must be 1, 50, 
75, 110, 134, 150, 300, 600, 1200, 1800, 
2000, 2400, 4800, 9600, 19200, or 
38400.) 


(Level 2): Invalid receive-data-rate. (Must be 0, 1, 
50, 75, 110, 134, 150, 300, 600, 1200, 
1800, 2000, 2400, 4800, 9600, 19200, or 


38400.) 


SET-PROMPT-STRING = EcNS int-array 


(Level 2): Invalid prompt-string. (Must be an array 
holding from 0 to 10 int parameters. Each 
of the items in the array must be an int in 
the range from 0 to 127.) 


(Level 3): Out of memory while parsing the 
parameter. 


SET-EOL-STRING = ‘cNT int-array 


(Level 2): Invalid LOL-string. (The array must hold 
from 0 to 2 int parameters. Each int in the 
array must be in the range from 0 to 127.) 


(Level 3): Out of memory while parsing the 
parameter. 


SET-BYPASS-CANCEL-CHAR = FcNU int 


(Level 2): Invalid numeric equivalent of bypass- 
cancel-character. (Must range from 0 to 
127.) 


ARM-FOR-BLOCK-MODE = *cOB int 


(Level 2): Unrecognized command. (Option 01 is 


not installed.) 


(Level 2): The communications queue size is 
smaller than the specified input block 


size. 


(Level 2): Invalid block-mode-arming parameter 


(must be O or 1). 


4115B OPERATORS 


Oc SET-BLOCK-CONTINUE-CHARS = cOC int int OH 
OCOO (Level 2): Unrecognized command. (Option 1 is not OHOO 
installed.) 
OCO3 (Level 2): Command is invalid at this time. (Terminal OHO2 
must not be armed for block mode.) — 
OC11 (Level 2): Invalid transmit-continue-char. (Must OHO03 
range from 0 to 127.) 
OC13 (Level 2): Transmit-continue-char must be OH11 
different from b/ock-master-char and 
block-end-char. 
OC21 (Level 2): Invalid receive-continue-char. (Must range OH12 
from 0 to 127.) 
OC23 (Level 2): Receive-continue-char must be OH21 
different from block-master-char and 
block-end-char. 
OH22 
OD SET-DUPLEX-MODE = FcOD ini 
ODOO (Level 0): Unrecognized command. (Option 01 is 
not installed.) | OL 
ODO1 (Level 2): Invalid duplex-mode (must be 0 to 3). OLOO 
OF SET-BLOCK-END-CHARS = EcOE int int OLOS 
OEOO (Level 2): Unrecognized command. (Option 1 Is not 
installed.) OL11 
OEO3 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 
OM 
OE11 (Level 2): Invalid ‘ransmit-end-char. (Must range 
from 0 to 127.) OMO0 
OE13 (Level 2): 7ransmit-end-char must be 
different from block-master-char and OMO03 
block-continue-char. 
OE21 (Level 2): Invalid receive-end-char. (Must range from OM11 
0 to 127.) OM13 
OE23 (Level 2): Receive-end-char must be 
different from block-master-char and 
block-continue-char. OMe1 
OM23 
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ERROR CODES 


SET-BLOCK-HEADERS = cOH int-array int-array 


(Level 2): Unrecognized command. (Option 01 Is 
not installed.) 


(Level 3): Out of memory while performing 
command. 


Command invalid at this time. (Terminal 
must not be armed for block mode.) 


(Level 2): 


(Level 2): Invalid char (must be 0 to 127) or array 
count (must be in range 0 to 10) in 


transmit-header. 


(Level 3): Out of memory while parsing the 


parameter. 


(Level 2): Invalid char (must be O to 127) or array 
count (must be in range 0 to 10) in receive- 


header. 


(Level 3): Out of memory while parsing the 


parameter. 


SET-BLOCK-LINE-LENGTH = cOL int 


(Level 2): Unrecognized command. (Option 01 not 


installed.) 


(Level 2): Command invalid at this time. (Terminal 


must not be armed for block mode). 


(Level 2): Invalid maximum-line-length. (Must range 


from 12 to 65535.) 


SET-BLOCK-MASTER-CHARS = -cOM int ini 


(Level 2): Unrecognized command. (Option 01 is 
not installed.) 


(Level 2): Command invalid at this time. (Terminal 


must not be armed for block mode.) 
(Level 2): 
(Level 2): 


Invalid transmit-master-char (0 to 127). 


Transmit-master-char must be 
different from block-end-char and 
block-continue-char. 


(Level 2): 
(Level 2): 


Invalid receive-master-char (0 to 127). 


Receive-master-char must be 
different from block-end-char and 
block-continue-char. 


ERROR CODES 


ON 
ONOO 
ONO3 


ON11 


ON12 


ON21 


ON22 
OP 

OP0O 
OP03 
OP11 
OP21 
OP31 
OP41 
os 

OS00 
OS03 
OS11 


OS21 


SET-BLOCK-NON-XMT-CHARS =  cON int-array OT 
int-array OT00 
(Level 2): Unrecognized command. (Option 01 is 
led. 
not installed.) OT11 

(Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

(Level 2): Invalid character code or array count in PA 
transmit-chars. (The array count must be PANO 
from 0 to 20, and the character codes 
must be from 0 to 127.) 

(Level 3): Out of memory while parsing the se 
parameter. 

(Level 2): Invalid character code or array count in Pele 
receive-chars. (The array count must be 
from 0 to 20, and the character code must PAi3 
be from Oto 127.) 

PA21 

(Level 3): Out of memory while parsing the 
parameter. 

PA22 

SET-BLOCK-PACKING = £cOP int int int int 

(Level 2): Unrecognized command. (Option 01 is PB 
not installed.) 

PBOO 

(Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

PB11 

(Level 2): Invalid transmit-unpacked-bits (must be 7 
or 8). 

PB12 

(Level 2): Invalid transmit-packed-bits (must be 6, 7, 
or 8). 

PB13 

(Level 2): Invalid receive-unpacked-bits (must be 7 
or 8). PB21 

(Level 2): Invalid receive-packed-bits (must be 6, 7, 
or 8). PB31 

SET-BLOCK-LENGTH = £cOS int int 

(Level 2): Unrecognized command. (Option 01 is 
not installed.) 

(Level 2): Command invalid at this time. (Terminal 
must not be or armed for block mode.) 

(Level 2): Invalid transmit-block-length (must range 
from 5 to 65535.) 

(Level 2): Invalid receive-block-length (must range 
from 5 to 65535.) 
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SET-BLOCK-TIMEOUT = cOT int 


(Level 2): 


(Level 2): 


Unrecognized command. (Option 01 is 
not installed.) 


Invalid timeout. (Must range from 0 to 
65535 seconds.) 


PORT-ASSIGN = ‘cPA device string int 


(Level 0): 
(Level 2): 
(Level 3): 
(Level 2): 


(Level 2): 


(Level 3): 


Unrecognized command. (Option 10 is 
not installed.) 


Invalid port identifier. (Must be PO:, P1:, 
or P2:.) 


Out of memory while parsing the 
parameter 


Port is in use. 


Invalid protocol identifier. (Must be 
PPORT, 4643, 4662, 4662/MP, 4662/NT, 
4663, 4663/NB, 4663/NT, or KATA). 


Out of memory while parsing parameter. 


SET-PORT-STOP-BITS = -cPB device int int 


(Level 0): 


(Level 2): 


(Level 3): 


(Level 2): 
(Level 2): 


(Level 2): 


Unrecognized command. (Option 10 is 
not installed.) 


Port identifier is invalid (must be PO:, P1:, 
or P2:). 


Out of memory while parsing the 
parameter. 


Port is busy. 


Invalid number-of-stop-bits (must be 
1 or 2). 


Invalid number-of-data-bits (must be 5, 6, 
7, or 8). 
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PC 
PCOO 


PCO02 


PC10 
PCi1 


PC12 


PC13 


PC21 


PC22 


PC30 


PC31 


PC32 


PC33 


PE 


PEOO 


PE11 


PE12 


PE13 
PE21 


PE22 
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PORT-COPY = cPC device string device 


(Level 0): 


(Level 3): 


(Level 2): 
(Level 2): 


(Level 3): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


Unrecognized command. (Option 10 is 
not installed). 


Out of memory while processing 
command. 


Source device does not exist. 


Invalid source (must be HO:, PO:, P1:, or 
P2:). 

Out of memory while parsing the 
parameter. 


Source is busy, or is a peripheral port that 
is not assigned the PPORT protocol. 


Invalid separator. (Must be the empty 
string or TO.) 


Out of memory while parsing the 
parameter 


Destination device is not installed. 


Invalid destination (must be HO:, PO:, Pi: 
or P2:, and must be different from the 
source port). 


Out of memory while parsing the 
parameter. 


Destination is busy or is a peripheral port 
that is not assigned the PPORT protocol. 


SET-PORT-EOF-STRING = ®cPE device int-array 


(Level 0): 


(Level 2): 


(Level 3): 


(Level 2): 
(Level 2): 


(Level 3): 


Unrecognized command. (Option 10 is 
not installed). 


Invalid port identifier (must be P0O:, P1:, or 
P2:). 

Out of memory while parsing the 
parameter. 

Port is busy. 


Invalid FOF-string. (The int-array must 
have from 0 to 10 elements, and each int 
in the array must be in the range from 0 to 
127.) 


Out of memory while parsing the 
parameter. 


PF 


PFOO 


PF11 


PF12 


PF13 
PF21 
PF31 


PF41 


Pi 
Pi00 


PIO02 
PI 


Pli2 


Pli3 
Pl21 
PI31 
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ERROR CODES 


SET-PORT-FLAGGING-MODE = cPF device int int 


int 


(Level O): 


(Level 2): 


(Level 3): 


(Level 2): 
(Level 2): 
(Level 2): 


(Level 2): 


Unrecognized command. (Option 10 is 
not installed.) 


Invalid port identifier (must be PO:, P1:, or 
P2:). 


Out of memory while parsing the 
parameter. 


Port is busy. 
Invalid flagging-mode (must be 0, 1 or 2). 


Invalid GO character (must be in range O 
to 127). 


Invalid STOP character (must be in range 
0 to 127; if non-zero, must be different 
from the GO character). 


MAP-INDEX-TO-PEN = -cPI device int int 


(Level 0): 


(Level 3): 
(Level 2): 


(Level 2): 


(Level 2): 
(Level 2): 
(Level 2): 


Unrecognized command. (Option 10 Is 
not installed.) 


No memory is available for the index map. 


Invalid port identifier (must be PO:, P1:, or 
P2:). 


Out of memory while parsing the 
parameter. 


Port is busy. 
Invalid index (must range from —1 to 255). 


Invalid pen-number (must range from 0 to 
299); 


ERROR CODES 


PL 
PLOO 


PLO2 


PL11 


PL12 


PL20 
PL21 
PL22 


PL23 


PL29 


PM 
PMO0O 


PM11 


PM12 


PM1i3 


PM22 


PP 


PPOO 


PP11 


PP12 


PP13 
PP21 


A-20 


PLOT = cPL string device 


(Level 0): Unrecognized command. (Option 10 is 


not installed.) 


(Level 3): Out of memory while attempting DMA 


transfer (Option 3A only). 


(Level 2): Invalid separator. (Must be the empty 


string or TO.) 


(Level 3): Out of memory while parsing the 


parameter. 
(Level 2): Destination device not installed. 
(Level 2): 


(Level 3): 


Invalid destination specifier 


Out of memory while parsing the 
parameter. 


(Level 2): Parameter 2 context error. (Device is write 


protected or busy.) © 


(Level 2): Device hardware error (disk drive is not 
ready or is write-protected, or DMA block 


transfer error). 


SET-PORT-EOL-STRING = ©cPM device int-array 


(Level 0): Unrecognized command. (Option 10 is 


not installed.) 


(Level 2): Invalid port identifier. (Must be PO:, P1:, 


or P2:.) 


(Level 3): Out of memory while parsing the 


parameter. 
(Level 2): 
(Level 3): 


Port is busy. 


Out of memory while parsing the 
parameter. 


SET-PORT-PARITY =  cPP device int 


(Level 0): Unrecognized command. (Option 10 is 


not installed). 


(Level 2): Invalid port specifier (must be PO:, P1:, or 


P2:). 


(Level 3): Out of memory while parsing the 


parameter. 


(Level 2): Portis busy. 


(Level 2): Invalid parity-mode (must be in range 0 to 


4). 


PQ 
PQOO 


PQt1 


PQ12 


PR 


PROO 


PR11 


PR12 


PR13 
PR21 


QB 


QBOO 


QB11 


QD 
QDOO 


QD11 


QN 
QNOO 


QN11 
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REPORT-PORT-STATUS =  cPQ device 


(Level 0): Unrecognized command. (Option 10 is 


not installed). 


(Level 2): Invalid port identifier (must be PO:, P1:, or 


P2:). 


(Level 3): Out of memory while parsing the 


parameter. 


SET-PORT-BAUD-RATE =  cPR device int 


(Level 0): Unrecognized command. (Option 10 is | 
not installed). 


(Level 2): Invalid port identifier (must be PO:, P1:, or 


P2:). 


(Level 3): Out of memory while parsing the 
parameter. 


(Level 2): 
(Level 2): 


Port is busy. 


Invalid baud-rate (must be 50, 75, 110, 
134, 150, 300, 600, 1200, 1800, 2000, — 
2400, 3600, 4800, 7200, or 9600). 


SET-COLOR-COPIER-DATA-RESOLUTION = -cQB 

int 

(Level 0): Unrecognized command (Option 9 is not 
installed). 


(Level 2): Invalid resolution (must be 1 or 2). 


SELECT-HARDCOPY-INTERFACE = £cQD int 


(Level 0): Unrecognized command (Option 9 is not 
installed). 


(Level 2): Invalid interface (must be 0 or 1). 


SET-NUMBER-OF-COPIES =cQN int 


(Level 0): Unrecognized command (Option 9 is not 
installed). 


(Level 2): Invalid number-of-copies (must be 0 or 
65535). . 


4115B OPERATORS 


Q0 
QOO00 


QO11 


QQ 


QQ00 


QR 


QROO 


QRO03 
QR11 


RA 
RAOO 


RA10 


RA11 


RA21 


RA31 


RB 


RBOO 


RB11 


RC 


RCOO 


RC11 


4115B OPERATORS 


SET-IMAGE-ORIENTATION = -cQO ini 


(Level 0): Unrecognized command (Option 9 is not 
installed). 


(Level 2): Invalid orientation (must be from 0 to 3). 


REPORT-COLORHARDCOPY-STATUS = -cQQ 


(Level 0): Unrecognized command (Option 9 is not 
installed). 


SET-COPIER-RESERVE-STATUS = -cQR int 


(Level 0): Unrecognized command (Option 9 is not 


installed). 
(Level 2): 
(Level 2): 


Color copier is not connected. 


Invalid reserve-sefting (must be 0 or 1). 


SET-VIEW-ATTRIBUTES = cRA int int int 


(Level 0): Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) 


(Level 2): Surface does not exist (has not 
been defined with SET-GSURFACE- 


DEFINITIONS command). 


(Level 2): Invalid surface-number. (4112: -1 to 3; 


4113: -1 to 4; 4115: -1 to 8.) 


(Level 2): Invalid wipe-index. (Must range from 0 to 


65535.) 


(Level 2): Invalid border-index. (Must range from 0 


to 65535.) 


SET-BACKGROUND-GRAY-LEVEL = -cRB ini 


(Level 0): Unrecognized command. (The terminal is 


not a 4112, 4113, or 4115.) 


(Level 2): Invalid gray-/eve/ (must range from O to 


100 or 1000 to 1100). 


SELECT-VIEW = FcRC ini 


(Level 0): Unrecognized command. (The terminal is 


not a 4112, 4113, or 4115.) 


(Level 2): Invalid view-number. (Must range from —1 


to 64.) 


FD 
RDOO 


RD10 


RD11 


RD12 


RE 
REOO 


RE11 


RFOO 


RG11 


RG21 


RG22 
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=RROR CODES 


SET-SURFACE-DEFINITIONS = -cRD int-array 


(Level 0): Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) 


(Level 2): Occupied undefined surface. (This com- 
mand would have resulted itn a dialog 
area viewport, pixel viewport, or num- 
bered graphic viewport residing on an 


undefined surface.) 


(Level 2): Invalid surface-defs array. (4112: array 
count: 1 to 3; ints: 0io 3; 4113: array 
count: 1 to 4; ints: Oto 4; 4115: array 
count: 1 to 8; ints: 0 to 8.) 


Out of memory while parsing the 
parameter. 


(Level 3): 


SET-BORDER-VISIBILITY = -cRE int 


(Level 0): Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) 


(Level 2): Invalid border-visibility-mode parameter 
(must be O, 1, or 2). 


SET-FIXUP-LEVEL = -cRF int 


(Level 0): Unrecognized command. (The terminal is 


not a 4112, 4113, or 4115.) 


(Level 1): Invalid fixup-/evel (must range from O to 


32767). 


SET-SURFACE-GRAY-LEVELS = ®cRG int int-array 


(Level 0): Unrecognized commana. (The terminal is 
not a 4112, 4113, or 4115.) 


(Level 2): Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 


TIONS command). 


(Level 2): Invalid surface-number. (4112: -1 or 1 to 


3; 4113: -1 or 1 to 4; 4115: -1 or 1 to 8.) 


(Level 2): Invalid surface-gray-levels array. (The 
array count must be even; the first int in 
each pair must be a color index in the 
range from 1 to 32767; the second int in 
each pair must be a valid gray-level: a 


number from 0 to 100 or 1000 to 1100.) 


(Level 3): Out of memory while parsing the 


parameier. 


ERROR CODES 


RH 
RHOO 


RH11 


Ri 


RIO0 


R10 


Rl 


Rii2 


RJ 


RJOO 


RJ11 


RK 
RKOO 


RK10 


RK11 


A-22 


SET-PIXEL-BEAM-POSITION = -cRH xy RL 
(Level 0): Unrecognized command. (The terminal is RLOO 
not a 4112, 4113, or 4115.) 
(Level 2): Invalid beam-position (4115: -23' to RL11 
2314). 
SET-SURFACE-VISIBILITY =  cRI int-array 
(Level 0): Unrecognized command. (The terminal is R412 
not a 4112, 4113, or 4115.) 
(Level 2): A surface in surface-numbers-and-visibili- 
ties does not exist (has not been defined RN 
with a SET-SURFACE-DEFINITIONS 
command). RNOO 
(Level 2): Invalid surface-numbers-and-visibilities 
array. (Surface numbers: 4112: 1 to 3; RN10 
4113: 1 to 4; 4115: 1 to 8. Visibility: 0 to 2 
for all terminals. Array count must be 
even and range from 2 to 65534.) RN11 
(Level 3): Out of memory while parsing the 
parameter. 
RN12 
LOCK-VIEWING-KEYS = cRJ int 
(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) RP 
(Level 2): Invalid /ocking-mode (must be 0 or 1). RPOO 
DELETE-VIEW = ‘cRK int RP11 
(Level 0): Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) RP21 
(Level 1): The designated view does not exist (has 
not been defined with a SELECT-VIEW 
command). RP22 
(Level 2): Invalid view-number (must range from —1 
to 64). 
RQ 
RQO0 
RQ11 
RQ12 
REV, JAN 1984 


RUNLENGTH-WRITE = ©cRL int-array 


(Level 2): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


(Level 2): Invalid runlength-code array. (The array 
count must range from 0 to 65535, and 
each int in the array must also range from 
0 to 65535 on a 4112 and 4113, and from 


0 to 23'—-1 ona 4115.) 


(Level 3): Out of memory while parsing the parame- 


ter, or while executing the command. 


SET-SURFACE-PRIORITIES =  cRN int-array 


(Level 0): Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) 


(Level 2): Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 


TIONS command). 


(Level 2): Invalid priorities array. (Surfaces: 4112: 1 
to 3; 4113: 1 to 4; 4115: 1 to 8. Priorities: 


4112: 0 to 4; 4113: 0 to 5; 4115: Oto 9.) 


(Level 3): Out of memory while parsing the 


parameter. 


RASTER-WRITE = ©cRP int char-array 


(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


(Level 2): Invalid number-of-pixels. (Must range 


from 0 to 65535.) 


(Level 2): There are too many or too few pixels in 
the code-array, or invalid codes are 


present (range for codes is ADE 32 to 96). 


(Level 3): Out of memory while parsing the 


parameter. 


SET-VIEW-DISPLAY-CLUSTER = cRQ int-array 


(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115). 


(Level 2): Invalid view-numbers array. (Each view 
number must range from —2 to 64; array 


count must be from 0 to 65535.) 


(Level 3): Out of memory while parsing the 


parameter. 


4115B OPERATORS 


RR 
RROO 


RR11 


RR21 


RR31 


RS 


RSOO 


RS11 


RS21 


RT 
RTOO 


RT11 


RT21 


RT31 


RU 


RUOO 


RU10 


RU11 


RU21 


RU31 


4115B OPERATORS 


RECTANGLE-FILL = &cRR xy xy int 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) 


Invalid first-corner. (4112, 4113: X = Oto 
639, Y = 0to 479; 4115: X = 0to 1279, Y 
= Oto 1023.) 


Invalid second-corner. (4112, 4113: X = 0 
to 639, Y = 0to 479; 4115: X = Oto 1279, 
Y = 0to 1023.) 


Invalid fi//-index (must range from 0 to 
65535.) 


SET-P!IXEL-VIEWPORT =  cRS xy xy 


(Level 0): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


Invalid first-corner. (4112, 4113: X = Oto 
639, Y = 0to 479; 4115: X = 0to 1279, Y 
= Oto 1023.) 


Invalid second-corner. (4112, 4113: X = 0 
to 639, Y = 0to 479; 4115: X = Oto 1279, 
Y = Oto 1023.) 


SET-PIXEL-WRITING-FACTORS = £cRT int int int 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (Terminal is not 
a 4115.) 


Invalid pixel-width parameter (range is 
~1280 to 1280). 


Invalid pixel-height parameter (range is 
—1280 to 1280). 


Invalid major-axis parameter (must be 0 
or 1). 


BEGIN-PIXEL-OPERATIONS = £cRU int ini int 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) 


Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 
TIONS command). 


Invalid surface-number. (4112: -1 to 3; 
4113: -1 to 4; 4115: -1 to 8.) 


Invalid AL U-mode (4112, 4113: 0 to 16; 
4115:0, 7,11, 12, 15, 17, or 18). 


Invalid bits-per-pixel. (4112: 0, 1, 2, 3, or 
6; 4113:0,1,2,3, 4, or 6; 4115: Oto 8.) 


RV 
RVOO 


RVO0O1 


RV 11 


RV21 


RW 
RWO0O0 


RW01 


RW11 


RWe1 


RA 
RX0OO 


RX10 


RX11 


RX21 


RX31 


RX41 
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ERROR CODES 


SET-VIEWPORT = FcRV xy xy 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) 


Invalid viewport size. (In the 4112 and 
4113, the viewport must not be more 


than 51.2 times larger than the current 


window.) 


Invalid first-corner. (4112, 4113: X = Oto 
4095, Y = Oto 3071; 4115: K = Oto 
4095, Y = Oto 3276.) 


Invalid second-corner. (4112, 4113: X = 0 
to 4095, Y = Oto 3071; 4115: X = Oto 
4095, Y = 0t0 3276.) 


SET-WINDOW = FcRW xy xv 


(Level O): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
nota4112, 4113, or 4115.) 


Invalid window size. (in the 4112 and 
4113, the viewport must not be more 
than 51.2 times larger than the current 
window.) 


Invalid first-corner (4112, 4113: X = Oto 
4095, Y = Oto 4095; 4115: X = Oto 4095 
or —23' to 23'-1,Y = 0 to 4095 or —23' to 
2311), 


Invalid second-corner (4112, 4113: X = 0 
to 4095, Y = Oto 4095; 4115: X = Oto 
4095 or —23' to 23'-1, Y = Oto 4095 or - 
2°'10 

231.4). 


PIXEL-COPY = &cRX int xy xy xy 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) 


The specified destination-surface does 
not exist. 


Invalid destination-surface. (4112: -1 to 3; 
4113: -1 to 4; 4115: -1 to 8.) 


Invalid destination-lower-left-corner. 
(4112, 4113: X = 0to 639, Y = 0to 479; 
4115: X = 0to 1279, Y = Oto 1023.) 


Invalid first-source-corner. (4112, 4113: 
X = 010639, Y = 0to 479; 4115: KX = 0 
to 1279, Y = 0to 1023.) 


Invalid second-source-corner. (4112, 
4113: 

X = 010 639, Y = 010 479; 4115: X = 0 
to 1279, Y = Oto 1023.) 
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ERROR CODES 


SA 
SA03 


SA10 
SA11 


SA21 


SA22 


SA31 


SA32 


SB 


SBOO 


SBOO 
SBO1 


SB02 


SBO3 


Sc 
SC02 


SC03 


SD 
SD03 


SD10 
SD11 


9D21 
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SET-SEGMENT-CLASS = £cSA int int-array int-array 


(Level 2): 


(Level 2): 
(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


(Level 3): 


Command invalid at this time: the speci- 
fied segment is currently being defined. 


Segment does not exist. 


Invalid segment-number. (Must be in the 
range from —3 to -1, or from 1 to 32767.) 


Invalid removal-array. (Each class num- 
ber must be —1 or from 1 to 64; array 
count must be from 0 to 65535.) 


Out of memory while parsing the 
parameter. 


Invalid addition-array. (Each class num- 
ber must be —-1 or from 1 to 64; array 
count must be from 0 to 65535.) 


Out of memory while parsing the 
parameter. 


BEGIN-LOWER-SEGMENT = cSB 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


Unrecognized command (the terminal 
firmware is version 1 or 2). 


The indicated segment already exists. 


Invalid for next lower segment number 
(current segment ID is 1). 


Not enough memory to begin segment, or 
out of memory while ending segment. 


Context error; command is invalid at this 
time. No segment is currently being 
defined, or a graphtext character is cur- 
rently being defined. 


END-SEGMENT = -cSC 


(Level 3): 


(Level 1): 


Out of memory while performing com- 
mand (4112, 4113, 4115 only). 


Invalid at this time: no segment is cur- 
rently being defined. 


SET-SEGMENT-DETECTABILITY = cSD int int 


(Level 2): 


(Level 2): 
(Level 2): 


(Level 2): 


Command is invalid at this time. (The 
specified segment is currently being 
defined.) 


Segment does not exist. 


Invalid segment-number (must range from 
—3 to -1, or 1 to 32767). 


Invalid detectability (must be 0 or 1). 


SE 
SE00 


SE02 


SE03 


SE10 
SE11 


SG 

SG02 
SG10 
SG11 


SG21 


SG31 


SH 
SH03 


SH10 
SH11 


SH21 


~ REV, JAN 1984 


BEGIN-NEW-SEGMENT = &cSE int 


(Level 0): 


(Level 3): 


(Level 2): 


(Level 2): 
(Level 2): 


Unrecognized command (the terminal 
firmware is version 1 or 2). 


Not enough memory to begin segment, or 
out of memory while ending segment. 


Command is invalid at this time (a 
graphtext character or a panel is currently 
being defined without a segment being 
defined). 


Segment already exists. 


Invalid segment-number (1 through 32767 
are valid). 


SET-GRAPHTEXT-FONT-GRID = cSG int int int 


(Level 3) 
(Level 2) 
(Level 2) 


(Level 2) 


(Level 2) 


Out of memory while defining font grid. 
Font already exists. 


Invalid font-number (must range from 0 to 
32767). | 


Invalid grid-width. (Must range from 1 to 
4095.) 


Invalid grid-height. (Must range from 1 to 
4095.) | 


SET-SEGMENT-HIGHLIGHTING = cSH int int 


(Level 2) 


(Level 2) 
(Level 2) 


(Level 2) 


Command is invalid at this time. (The 
specified segment is currently being 
defined.) 


Segment does not exist. 


Invalid segment-number (must range from 
-—3 to -1, or from 1 to 32767). 


Invalid highlighting (must be 0 or 1). 


4115B OPERATORS 


Sl 


5102 


S!I03 


S!I10 


Sli 


$121 


S!31 


S141 


S151 


Sik 


SKO02 


SK10 
SK11 


SK13 


SL 


SL11 


SLi2 


SL21 


SL22 


4115B OPERATORS 


SET-SEGMENT-IMAGE-TRANSFORM = €cSI int 
real real real xy 


(Level 3) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


Out of memory while transforming 
segment. 


Command is invalid at this time. (The 
specified seqment is currently being 
defined.) 


Segment does not exist. 


Invalid segment-number (must range —3 to 
~1, or 1 to 32767). 


Invalid x-scale-factor. (Must range from 
~32767.0 to 32767.0.) 


Invalid y-scale-factor. (Must range from 
~32767.0 to 32767.0.) 


Invalid rotation-angle. (Must range from 
-~32767.0 to 32767.0.) 


Invalid position. (4112, 4113, 4114, 4116: 
X = Oto 4095, Y = Oto 4095: 4115: X = 
0 to 4095 or ~2*' to 23'-1: Y = 0 to 4095 
or —23' to 23'—1,) 


DELETE-SEGMENT = ©cSK int 


(Level 3) 


(Level 1) 
(Level 2) 


(Level 2) 


Out of memory while attempting to delete 
a segment (4112, 4113. 4115 only). 


Segment does not exist. 


Invalid segment-number (must be -3, —1, 
or from 1 to 32767). 


Segment specified is an active 
GIN-cursor. 


SET-CURRENT-MATCHING-CLASS = cSL int- 
array int-array 


(Level 2) 


(Level 3) 


(Level 2) 


(Level 3) 


Invalid :nclusion-set. (Class numbers 
must be -1, or from 1 to 64; the array 
count must be from 0 to 65535.) 


Out of memory while parsing the 
parameter. 


Invalid exclusion-set. (Class numbers 
must be -1, or from 1 to 64; the array 
count must be from O to 65535.) 


Out of memory while parsing the 
parameter. 


Si 
SMO3 


SM10 


SM11 


SM21 


SN 
SNOO 


SNOO 
SNO1 


SNO2 


SNO3 


SO 


ERROR CODES 


SET-SEGMENT-WRITING-MODE = cSWM int int 


(Level 2) 


(Level 2) 
(Level 2) 


(Level 2) 


Command is invalid at this time. (The 
specified segment is currently being 
defined. 


Segment does not exist. 


Invalid segment-number (must range from 
~3 to 32767). 


Invalid writing-mode (must be 0 or 1). 


BEGIN-HIGHER-SEGMENT = cSN 


(Level 0) 


(Level 2) 
(Level 2) 


(Level 3) 


(Level 2) 


Unrecognized command (the terminal 
firmware is version 1 or 2). 


The indicated segment already exists. 


Invalid for next higher segment number 
(current segment ID is 32767). 


Not enough memory to begin segment, or 
out of memory while ending segment. 


No segment is currently being defined, or 
a graphtext character is currently being 
defined. 


BEGIN-SEGMENT =  cSO ini 


SO00' (Level 4) Segment transform error. Scale-factor 


SO02 


SO003 


SO10 


SO11 


SP 
oP 11 


(Level 3) 


(Level 2) 


(Level 2) 
(Level 2) 


cannot be 0, segment scaled out of win- 
dow, or window decreased beyond scaled 
segment. 


Not enough memory to begin segment, or 
out of memory while defining segment. 


Another segment, a graphtext character, 
ora panel is currently being defined. 


Segment already exists. 


Invalid segmnent-number (must range from 
1 to 32767). 


SET-PIVOT-POINT = -cSP xy 


(Level 2) 


Invalid pivot-point (4115: X and Y must 
be from —2°' to 23'—1). 


Although error SOOO starts with the opcode SO, it is not caused by the Begin 
Segment (&cSO) command, but by the interaction of the Set-Segment-Image- 
Transform (cSl) and the Set-Window (&cRW) commands. Error SO00 cannot be 
suppressed by setting the error threshold to 4. (See the 4//0 Series Command 
Reference Manual tor more information.) 
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ERROR CODES 


SQ 
SQ10 
SQ11 


SQ21 


SQ22 


SR 
SRO2 


SRO3 
SR10 
SR11 
SR20 

SR21 


SS 
SS03 


$S10 
SS11 


$S21 


A-26 


REPORT-SEGMENT-STATUS = cSQ int char-array 
(Level 2) Segment does not exist. 


(Level 2) Invalid segment-number (must range from 
~3 to 32767). 


Invalid array of codes. (Must include only 
the uppercase letters A, D, H,!,M,P,S, V, 
and X. Also, the array count must be in 
the range from 0 to 65535.) 


(Level 2) 


(Level 3) Out of memory while parsing the 
parameter. 


RENAME-SEGMENT = ©cSR int int 


(Level 3) Out of memory while renaming a segment 


(4114, 4116 only). 


(Level 2) Command is invalid at this time. (The 


specified segment is currently being 
defined.) 


(Level 2) 
(Level 2) 


Segment does not exist. 


Invalid old-segment-number (must range 
from 1 to 32767). 


(Level 2) Asegment with the o/d-segment-number 


already exists. 


(Level 2) Invalid new-segment-number (must range 


from 1 to 32767). 


SET-SEGMENT-DISPLAY-PRIORITY = *cSS int int 


(Level 2) Command is invalid at this time. (The 


specified segment is currently being 
defined.) 


(Level 2) 
(Level 2) 


Segment does not exist. 


Invalid segrnent-number (must range from 
—3 to -1, or from 1 to 32767). 


(Level 2) Invalid priority-number (must range from 


~32768 to 32767). 


ST 
ST02 


ST03 


ST10 


ST11 


ST20 


ST21 


SU 
SU03 


SV 


SV02 


SV03 


SV10 


oV11 


sV21 
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BEGIN-GRAPHTEXT-CHARACTER = cST int int 


(Level 3) Out of memory while defining graphtext 
character, or not enough memory to begin 
the definition. 


(Level 2) Command is invalid at this time. (A 
graphtext character is currently being 


defined.) 


(Level 2) The font specified has no grid defined for 
it. 


(Level 2) Invalid font number (the range is from 0 to 


32767). 


(Level 2) The character specified has already been 


defined in this font. 


(Level 2) Invalid character number (the range is 


from 32 to 126). 


END-GRAPHTEXT-CHARACTER = -cSU 


(Level 1) This command is invalid at this time. (No 
graphtext character is being defined.) 


SET-SEGMENT-VISIBILITY =  cSV int 


(Level 3) Out of memory while performing com- 


mand (4112, 4113, 4115 only.) © 


Command is invalid at this time. (The 
specified segment is currently being 
defined.) 


(Level 2) 


(Level 2) 
(Level 2) 


Segment does not exist. 


Invalid segment-number (must range from 
-3 to 32767). 


(Level 2) Invalid visibility (must be 0 or 1). 


4115B OPERATORS 


SX 
SX02 


SX03 


SX10 


SX11 


SX21 


SZ 


$203 


SZ10 


S211 


SZ20 


SZ21 


TB 


TBOO 


TB11 


TB21 


TB31 


4115B OPERATORS 


SET-SEGMENT-POSITION =  cSxX int xy 


(Level 3) Out of memory while performing com- 


mand. 


(Level 2) Command is invalid at this time (the spec- 


ified segment is currently being defined; 
4112, 4113, 4115 only). 


(Level 2) 
(Level 2) 


Segment does not exist. 


Invalid segment-number (must range from 
~3 to 32767.) 


Invalid position (4112, 4113, 4114, 4116: 
X = Oto 4095, Y = 0 to 4095; 4115: X = 
0 to 4095 or -23' to 23'-1; Y = Oto 4095 
or —2°' to 231-1.) 


(Level 2) 


DELETE-GRAPHTEXT-CHARACTER = ®cSZ ini int 


(Level 2) Command is invalid at this time. (A 
graphtext character is currently being 


defined.) 


(Level 1) The specified font does not exist (no grid 


has been defined for that font). 


(Level 2) Invalid font-number (must range from -1 


to 32767). 


(Level 1) The character specified does not exist in 


this font. 


(Level 2) Invalid char-number. (Must be -1, or from 


32 to 126.) 


SET-BACKGROUND-COLOR = £cTB int ini int 


(LevelO) Unrecognized command (terminal is nota 


4112, 4113, or 4115). 


(Level 2) Invalid first-color-coordinate. (HLS mode: 
~32768 to 32767; RGB and CMY modes: 
0 to 100; 4115 Machine RGB mode: 0 to 


255.) 


(Level 2) Invalid second-color-coordinate (HLS, 
RGB, and CMY modes: 0 to 100; 4115 


Machine RGB mode: 0 to 255). 


Invalid third-color-coordinate (HLS, RGB, 
and CMY modes: G to 100 and 1000 to 
1100; 4115 Machine RGB mode: 0 to 255 
and 1000 to 1255). 


(Level 2) 


TG 
TGOO 


TG10 


TG11 


TG21 


TG22 


TW 


TMOO 


TM114 


TM21 


TM31 


UB 
UBOO 


UBi1 
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SET-SURFACE-COLOR-MAP = cTG int int-array 


(Level 0) Unrecognized commana. (The terminal is 
nota 4112, 4113, or 4115). 


Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 
TIONS command). 


(Level 2) 


Invalid surface-number. (4112: -1, 1 to 3; 
4113: -1, 1 to 4; 4115: -1, 1 to 8). 


(Level 2) 


(Level 2) Invalid co/or-mixtures array. (The array 
count must be a multiple of four in the 
range from 0 through 65532. The first int 
in each group be from 0 to 32767. The 
other three ints must be valid HLS, RGB, 
or CMY values, according to the most 
recent SET-COLOR-MODE command. If 
the HLS system is in effect, the Hue 
parameter must be in the range from 
-—32768 to + 32767, while the Lightness 
and Saturation parameters must be in the 
range from 0 to 100. If the RGB or CMY 
system is in effect, then the first two color 
coordinates must be in the range 0 to 100, 
and the third color coordinate must be in 
the range from 0 to 100 or 1000 to 1100. 
Ina4115, if the Machine RGB system is 
in effect, the first two color coordinates 
must be in the range from 0 to 255, and 
the third color coordinate must be in the 
range from 0 to 255 or 1000 to 1255.) 


(Level 3) Out of memory while parsing the 


parameter. 


SET-COLOR-MODE =  cTM int int ini 


(Level 0): Unrecognized command (terminal is not a 


4112, 4113, or 4115). 


(Level 2): Invalid color-specify-mode (4112, 4113: 0 


to 3; 4115: 0 to 4). 


(Level 2): Invalid color-overlay-mode (must range 


from 0 to 3). 


(Level 2): Invalid gray-mode (must be 0, 1, or 2). 


SET-DRAW-BOUNDARY-MODE = ©cUB int 


(Level 0) Unrecognized command. (Terminal is not 


a 4115.) 


(Level 2) Invalid draw-boundary-mode (must be 0 


or 1). 
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UR 
UROO 


UR11 


UR12 


UX 
UX00 


UX11 


UX21 
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DRAW-RECTANGLE =  cUR xy-array 


(Level 0) Unrecognized command. (Terminal is not 
a 4115.) 


(Level 2) Invalid opposite-corners array. (There 
must be an even number of xys in the 
array. Each xy must range from —2°' to 
23'_1; array length must be from 0 to 
65535.) 


(Level 3) Out of memory while parsing the 
parameter. 


SET-COORDINATE-MODE = cUX int 


(Level O) Unrecognized command. (Terminal is not 
a 4115.) 


(Level 2) Invalid coordinate-mode (must be 0, 1, 
Or 2). 


(Level 2) Invalid int-report-size (must be 0, 
or 2 to 6). 


UW  SET-OVERVIEW-WINDOW = =cUW xy xy 


UW00 (Level0) Unrecognized command. (Terminal is not 
a 4115.) 


UW11 (Level 2) Invalid absolute-lower-left parameter 
(both X and Y must be —2°" to 23'—1). 


UW21 (Level 2) Invalid absolute-upper-right parameter 
(both X and Y must be —2°" to 29'-1). 
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%! SELECT-CODE = Fc%l! int 

%!00 (LevelO) Unrecognized command; terminal firm- 
ware Is Version 3. 

%!l11 (Level2) Invalid command-set (must be 0 or 1.) 

[@ INSERT-CHARACTER = CS/Pn @ 

[@11 (Level 2) Invalid number-of-characters parameter 
(range is O to 32767). 

[A CURSOR-UP = CS7PnA 

[Ai1 (Level 2) Invalid number-of-lines parameter (range 
is 0 to 32767). 

[B CURSOR-DOWN = CS/PnB 

[Bi1 (Level2) Invalid number-of-lines parameter (range 
is 0 to 32767). 

[C CURSOR-FORWARD = CS/PnC 

[C11 (Level2) Invalid number-of-columns parameter 
(range is 0 to 32767). 

[D CURSOR-BACKWARD = CS/ Pn D 

[D11 (Level2) Invalid number-of-columns parameter 
(range is 0 to 32767). 

if HORIZONTAL-AND-VERTICAL-POSITION 

= CS/PnPnf 

[f11 (Level 2) Invalid /ine-number parameter (range is 0 
to 32767). 

[f21 (Level2) Invalid column-number parameter (range 
is O to 32767). 

ig TABULATION-CLEAR = CSI Psg 

[fgi1  (Level2) Invalid tab-clear-extent parameter. (must 
be 0, 1, or 2). 

[fH CURSOR-POSITION = CS/PnPnH 

[H11  (Level2) Invalid /ine-number parameter (range is 0 
to 3276/7). 

[H21 (Level2) Invalid column-number parameter (range 
is O to 32767) 
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SET-MODE = CS/PsPs...n 


(Level 2) Invalid mode value. 


CURSOR-HORIZONTAL-TAB = CS/Pni 


(Level 2) Invalid value (range is 0 to 32767). 


ERASE-IN-DISPLAY = CS/ Ps J 


(Level 2) Invalid erase-extent parameter (must be 0, 


TOF 2): 


ERASE-IN-LINE = CS/PS K 


(Level 2) Invalid erase-extent parameter (must be 0, 


1, Or 2). 


INSERT-LINE = CS/7Pnt 


(Level 2) Invalid number-of-lines parameter (range 


is 0 to 32767) 


RESET-MODE = CS/PsPs... i 


(Level 2) Invalid mode value. 


DELETE-LINE = CS7PnM 


(Level 2) Invalid number-of-lines parameter (range 


is Oto 32767). 


SELECT-GRAPHIC-RENDITION = CS7PsPs...m 


(Level 2) Invalid rendition parameter (must be 0, 1, 


4,5,or7). 


DEVICE-STATUS-REPORT = CS/Psn 


(Level 2) Invalid device parameter (the only valid 


device specifier is 6). 


DELETE-CHARACTER = CS/PnP 


(Level 2) Invalid number-of-characters parameter 


(range Is 0 to 32767). 


SCROLL-DOWN = CS/Pns 


(Level 2) Invalid number-of-lines parameter (range 


is 0 to 32767). 
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[T SCROLL-DOWN = CS/PnT 


[T11 (Level 2) Invalid number-of-lines parameter (range 
is O to 32767). 


[X ERASE-CHARACTER = CS/Pn X 


[X11 (Level2) Invalid number-of-characters parameter 
(range is 0 to 32767). 


[Z CURSOR-BACKWARD-TAB = CS/ Pn Z 


[Zi1  (Level2) Invalid number-of-tabs parameter (range 
is 0 to 32767). 


b ENABLE-MANUAL-INPUT = cb 


No errors are detected for this command. 


Cc RESET-TO-INITIAL-STATE = cc 


No errors are detected for this command. 


D INDEX = -cD 


No errors are detected for this command. 


E NEXT-LINE = cE 


No errors are detected for this command. 


H HORIZONTAL-TAB-SET = cH 


No errors are detected for this command. 


M REVERSE-INDEX = -cM 


No errors are detected for this command. 


7 RESTORE-CURSOR = §c7 


No errors are detected for this command. 


8 RESTORE-CURSOR = *c8 


No errors are detected for this command. 


DISABLE-MANUAL-INPUT = c‘ 


No errors are detected for this command. 
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Appencliy 


POWER-UP SEQUENCE AND SELF-TIEST 


This appendix explains the messages that can appear on 
the screen during the power-up sequence if a problem is 
detected. It also explains how to use the terminal’s exten- 
sive self-test procedure. 


TRE POWER-UP SEQUENCE 


Each time you turn the terminal on, it automatically tests 
parts of its memory and circuitry. This is called the power-up 
sequence. \t takes from 15 to 60 seconds, depending on 
what options your terminal has, and requires no operator 
interaction. 


During the power-up sequence, the lights in the keyboard 
go through the following sequence: 


1.  Alllights turn on. 

The Caps Lock light turns off. 

All other lights turn off. 

The XMT and RCV lights flash once simultaneoully. 


Os ae an 


All lights turn off. 


If the terminal bell does not ring during the power-up 
sequence (within 60 seconds of turning the terminal on), 
press the Page key. The screen is erased and the cursor 
flashes in the upper-left corner of the screen. If the dialog 
area is enabled, the light in the DIALOG key is on and the 
Cursor appears on the first available line of the the dialog 
area. AS soon as the cursor appears on the screen, the ter- 
minal is ready for use. 
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lf the power-up sequence detects an error, the terminal bell 
rings one, two, or three times, depending on the severity of 
the problem. There may also be a message on the screen. 


If the power-up sequence encounters an error that will not 
prevent you from using the terminal (a non-fatal error), the 
bell rings one time and a message is displayed on the 
screen. 


If the bell rings twice, more information is available. See the 
submessages discussion later in this section. 


lf the bell rings three times, a fata/ error has occurred. Fur- 
ther use of the terminal is not possible until the error is cor- 
rected. See the Fatal Errors discussion later. 


POWER-UP ERROR 


An example of a power-up error occurs when a problem 
exists that prevents you from using one of the terminal’s 
options. If this happens, the bell rings once and a message 
is displayed. For example, if the disk option failed the 
power-up sequence, the following message would appear: 


ROM Set: 42-Fail 


If there is a problem with a tablet option, the following mes- 
sage appears: 


ROW Set: 13-Fail 


When an option fails, that option cannot be accessed but 
the rest of the terminal’s features can still be used. You can 
report the failure to a service person, or run the self-test pro- 
cedure (described later in the appendix) to isolate the failure 
more specifically. 
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If an error occurs when the terminal is checking its key- 
board, the following message can appear: 


Keyboard !l-D — XX 


where XX is a keyboard ID value. If this occurs, record the 
message and contact a service person. 


The terminal has a setup memory, which remembers many 
of the terminal’s parameters or settings after it is turned off. 
These attributes are reinstated the next time the terminal is 
turned on. If that memory fails, the terminal bell rings once 

and the following message appears on the screen: 


Setup Defaults Reset 


This occurs if the terminal’s configuration has been altered 
by putting in or taking out a circuit board. It also occurs if the 
battery that powers the setup memory fails. If the setup 
memory battery fails, all parameters are reset to default. 


FATAL ERRORS 


If the power-up sequence encounters a fatal error, then the 
terminal is not operational. If that happens, the terminal bell 
rings three times. If the power-up sequence encounters a 
fatal error before the screen is checked, the terminal bell 
rings three times and the keyboard lights will indicate a 
code for the test that failed. 


If this occurs, record the light pattern and report it to a quali- 
fied service technician. You may also want to run the self- 
test procedure, explained later in this section, which 
provides more detailed information that you can relay to a 
qualified service technician. 


When there is a fatal error, the terminal cannot be operated 
except to run the self-test procedure. 
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GENERAL SELF-TEST 


The power-up sequence is an abbreviated test of the termi- 
nal’s memory and circuitry. 


A more extensive test of the terminal’s operating conditions 
is initiated by the SELF TEST button. Self-test thoroughly 
tests the terminal and allows a service technician to make 
any necessary adjustments. 


if the terminal detects an error in the power-up sequence, 
you can run the self-test procedure to isolate the problem. 
You can then report the specific problem to a technician. 


Self-test is initiated by pressing the SELF TEST and MAS- 
TER RESET buttons (Figure B-1) in the following sequence: 


1. Press SELF TEST. 


2. Continue to hold SELF TEST while you press and 
release MASTER RESET. 


3. Continue to hold SELF TEST until the keyboard indica- 
tor lights begin to cycle. 


4. Release SELF TEST. 


Approximately 20 seconds after SELF TEST begins, the 
keyboard bell will ring once. Press any keyboard key to con- 
tinue, or wait 20 seconds and the test continues automati- 
Cally. 


During self-test, the keyboard light patterns continue to | 
change as tests are run. If a module fails, the terminal bell 
rings twice, the Caps Lock light begins to blink, and a light 
pattern remains on for 20 seconds, indicating which test has 
failed. Record that pattern to report to a technician. 
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Figure B-1. The MASTER RESET and SELF TEST Buttons. 
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Submessages 


In addition to this intial light-coded message, many mes- 
sages have up to three submessages which can provide a 
technician with even more information about the problem. 


lf you want to view the submessages, start the following 
sequence within 20 seconds after the initial message 
appears. (If you take no action within 20 seconds, the sub- 
messages will appear at 20-second intervals.) 


1. Press the Rtn key or Space bar. 


2. The terminal bell rings twice and another light pattern is 
displayed. 

3. Record the light pattern and press Rtn or the Space bar 
again. 

4. Ifthere is another submessage, the bell rings twice and 
another light pattern is displayed. 


5. Record the light pattern and press Rtn or the Space 
bar. 
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6. If there is a third submessage, the bell rings twice and 
another light pattern ts displayed. 


7. Record the light pattern and press Rtn or the Space 
bar. =" 


8. When you have seen all of the submessages, there is 
no bell when you press Rin or the Space bar, the light in 
the Caps Lock key stops blinking, and the indicator 
light pattern changes to indicate that the next test in the 
self test procedure is being run. 


Most error messages are displayed in this manner as the 
terminal checks its display. After the display has been 
checked, option error messages are displayed on the 
screen as well as by light patterns. If the test halts at this 
point, it is because the screen is filled with error messages. 
Make a hard copy or write down the error messages. Press 
the Page key and the test will continue. 


The self-test procedure is explained in more detail in Vol- 
ume 2 of the 41/5B Service Manual. 
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AESETTING SETUP MEMORY 


You may find it necessary or desirable to restore the termi- 
nal’s environment to the factory defaults. This can be 
accomplished with the self-test procedure. To do so, take 
the following steps: 


1. Initiate the self-test as explained earlier in this 
appendix. 


2. When the bell rings once, press and hold the Ctrl key 
while you press and release the C key, then release the 
Ctrl key. This causes the light in the Caps Lock key to 
stop flashing and the following menu ts displayed on 
the screen: 


411X Menu 

ft sas. Display 

fe Processor Board 

2 SPP] 

f4 Disk 

Selection 

Funetion Key-Test Selection 
*“C-411X Menu 
“D-Current Menu 

“E-End 

it 


NOTE 


The exact contents of the menu will depend on 
which options are installed in your terminal. 


3. Press Function Key 2 (F2). The following menu appears 


on the screen: 


Processor Board Menu 

fl CMOS—-Reset 

fe Keyboard 

f3 Host Port 

Selection 

Function Key-Test Selection 
“C-411X Menu 

“D-Current Menu 

“E-End 


ry 
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4. Press Function Key 1 (F1). The following message 
appears below the menu: 


Processor Board Menu 


f1 CMOS-Reset 

fe Keyboard 

f3 Host Port 

Selection 

Function Key-Test Selection 
“C-411X Menu 

“D-Current Menu 

“E-End 

ara 

CMOS-Reset 

Selection 

Function Key-Test Selection 
“C-411X Menu 

“D-Current Menu 

“E-End 

% 


The term CMOS-Reset means that the Setup memory 
has been restored to its factory default values. 


5. Press and hold the Ctrl key while you press and release 
the E key, then release the Ctrl key. The terminal exits 
from the self-test procedure, runs the pcwer-up 
sequence, and when the cursor appears, is ready for 
use. 
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ESCAPE SEQUENCE COMMANDS 


The commands that the operator most commonly uses have 
an English-like format and are called setup commands, as 
explained in Section 6. 


However, the terminal can execute many more commands, 
which are issued in a format called escape sequences. They 
are called escape sequences because the first character in 
the command is always an ASCII escape character. All ter- 
minal commands (including setup commands and com- 
mand keys) have an escape sequence format. 


Although escape sequences are primarily used by the host 
to send commands to the terminal, you can enter an escape 
sequence from the terminal as well, in either Setup or Local 
modes. The escape sequences are entered in a slightly dif- 
ferent format for each of the two modes. 


This appendix briefly discusses escape sequence com- 
mands and lists the format for each. See the 4//0 Series Host 
Programmers Manual and the 4110 Series Command Refer- 
ence Manual for details on the use of escape sequences. 


TWO FORMATS 


There are two different formats for escape sequence 
commands. 


One format consists of the escape character followed by a 
single-character op code. Escape sequences in this format 
can only be entered in Local mode. In a general form, this 
could be represented as follows: 

EcX 


(Fc represents the escape character, X represents a single 
ASCII character.) 
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The second format consists of the escape character fol- 
lowed by a two-character op code and sometimes one or 
more parameters. Escape sequences in this format can be 
entered in either Local or Setup modes, though they are 
entered differently in each mode. This format could be rep- 
resented as follows: 


EcXX parameter parameter... 


The -c represents the escape character. Each X represents 
a single ASCII character. Each parameter can be an ASCII 
character, a string of ASCII characters, or a real number. 


ESCAPE SEQUENCES 
IN SETUP MODE 


All escape sequence commands that consist of the escape 
character followed by a two-character op code can be exe- 

cuted in Setup mode. The following list details the format of 
escape sequences in Setup mode: 


© The first character in the command is the escape charac- 
ter (ASCII 27). 


© All alphabetic characters must be upper case. 


© There is no space between the escape character and the 
two-character op code of the command. 


© If the command has parameters, enter one or more 
spaces after the op code and then enier the parameters 
with one or more spaces between each parameter. 


© Enter keyword parameters in their English-like format; 
enter numeric values in the normal way (special encod- 
ing is not necessary as it is in Local mode). 


© Terminate the command with a carriage return (CR) which 
causes the command to be executed. 
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For example, if the dialog area is enabled but not visible, 
you can press the DIALOG key to make the dialog area visi- 
ble. However, there is also an escape sequence command 
that makes the dialog area visible. 


You can execute that command in Setup mode as follows: 


1. Putthe terminal into Setup mode. If the light in the SET 
UP key is on, the terminal is already in Setup mode. If it 
is not on, press the SET UP key and the light turns on 
as the terminal enters Setup mode. 


2. Theterminal should not be in Local mode. The light in 
the LOCAL key should be off; if it is on, press the key 
and the light will go off as the terminal leaves Local 

mode. — 


3. The light in the Caps Lock key should be on, indicating 
that the key is active and all alphabetic characters will 
be in upper case. 


4. Enter the following command: 


EcLV YESCR 


That is, press the Esc, L, and V keys with no 
spaces between them. Then press the Space bar, 
enter the keyword YES, and press the Rtn key. The 
characters are echoed on the screen as you enter 
them and the command is executed when you enter 
the carriage return. If the dialog area was not visible 
before you entered the command, it becomes visi- 
ble. If the dialog area was already visible, nothing | 
happens. 


The following command initializes the terminal for Graphics 
Input (GIN) mode, setting it to use the thumbwheels as the 
input device for ten points: 


EcIE 0 10°R 


Press the SET UP key to exit from Setup mode. You can use 
the thumbwheels to locate the crosshair cursor and press 
ten alphabetic keys to exit from GIN mode. Or, you can put 
the terminal back into Setup mode and enter the following 
escape sequence command: 


EcID 0°R 


C-2 


ESCAPE SEQUENCES 
INLOCAL MODE 


When the terminal is in Local mode, you can execute both 
4010 and 4110 Series escape codes. In both cases, escape 
sequences have the following characteristics. Notice that 
the first two characteristics are the same as Setup mode, 
but the rest are different: 


© The first character in the command is the escape charac- 
ter (ASCII 27). 


® All alphabetic characters must be upper case. 


@® Nocarriage return is necessary; the command is exe- 
cuted as soon as you enter the last character. 


@ Characters are not echoed on the screen as you type 
them. 


@ Parameters of a command are not delimited by a space 
(although a space is a valid character in some com- 
mands). | 


® Keywords and numeric values greater than nine are 
entered in an encoded. form (see the 4/10 Series Com- 
mand Reference Manual). 


The escape sequence to make the dialog area visible can 
be entered in Local mode as follows: 


1. Put the terminal into Local mode. If the light in the 
LOCAL key is on, the terminal is in Local mode. If itis 
not on, press the LOCAL key and the light turns on as 
the terminal enters Local mode. 


2. Theterminal should not be in Setup mode. The light in 
the SET UP key should be off; if it is on, press the key 
and the light will go off as the terminal leaves Setup 
mode. 


3. The light in the Caps Lock key should be on, indicating 
that the key is active and all alphabetic characters will 
be in upper case. 


4. Pressthe following keys; the characters will not be 
echoed on the screen. 


EcLV1 
The command is executed when you enter the last charac- 
ter in the command. If the dialog area was not visible before 


you entered the command, it becomes visible. lf the dialog 
area was already visible, nothing happens. 
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The following command initializes the terminal for Graphics 
Input (GIN) mode, setting it to use the thumbwheels as the 
input device for ten points: 


EcIEO: 


(The colon at the end of the command is the coded form of 
the integer 10 in Local mode escape sequence commands.) 


Press the LOCAL key to exit from Local mode. You can use 
the thumbwheels to locate the crosshair cursor and press 
ten alphabetic keys to exit from GIN mode. Or, you can put 
the terminal back into Locai mode and eniez the following 
escape sequence command: 


ESCAPE SEQUENCE COMMANDS 


ESCAPE SEQUENCE 
COMMAND SUMMARY 


The rest of this appendix lists the terminal's 4110 Series 
escape sequences. They are listed alphabetically according 
to their one- or two-character op code. The setup command 
is shown if the escape sequence has one. 


Parameters for escape sequence commands are explained 
in the 47/0 Series Command Reference Manuai and the 4//0 
Series Host Programmers Manual. 


EcIDO 


Escape Sequence 
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ESCAPE SEQUENCE COMMAND SUMMARY 


Cornmand 


Setup Command 


Ec! char ENABLE-4953-TABLET-GIN None 

DISABL E-4953-TABLET-GIN None 
EcIA int SET-PICK-APERTURE GINPICKAPERTURE 
EcIC int int SET-GIN-CURSOR GINCURSOR 
EcID int DISABLE-GIN GINDISABLE 
EcIE int int ENABLE-GIN GINENABLE 
EcIF int int int SET-GIN-STROKE-FILTERING TBFILTER 
EcIG int int int SET-GIN-GRIDDING GINGRIDDING 
EcIH int SET-TABLET-HEADER-CHARACTERS TBHEADERCHARS 
Ecil int int SET-GIN-INKING GININKING 
EcIL int SET-REPORT-MAX-LINE-LENGTH None 
EcIM int SET-REPORT-EOM-FREQUENCY REOM 
EcIN int SET-TABLET-SIZE TBSIZE 
EcIP int REPORT-GIN-POINT None 
EciQ char char REPORT-TERMINAL-SETTINGS None 
EcIR int int SET-GIN-RUBBERBANDING GINRUBBERBANDING 
EcIS int char char SET-REPORT-SIG-CHARS RSIGCHARS 
EcIT int SET-TABLET-STATUS-STRAP TBSTATUS 
EclV int int xy xy SET-GIN-AREA GINAREA 
EcIW xy xy SET-GIN-WINDOW GINWINDOW 
EclX int xy SET-GIN-DISPLAY-START-POINT GINSTARTPOINT 
EcJB string ACTIVATE-LPOS LPOS 
EcJC string string string COPY COPY 
EcJD string string string DIRECTORY DIRECTORY 
EcJE STOP-SPOOLING STOP 
ECJF string FORMAT-VOLUME FORMAT 
EcJH int SET-DMA-BLOCK-SIZE None 
EcJd string DISMOUNT DISMOUNT 
EcJK string DELETE-FILE DELETE 
EcJL string LOAD LOAD 
EcUP string int PROTECT-FILE PROTECT 
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Escape Sequence 


EcJQ string 

EcJR string string string 
EcJS string string string 
EcJU int 

EcJV string int string string 


ECKA int 

EcKC 

EcKD int int-array 
ECKE int 

EcKF int 


EcKH int 
EcKI int 

ECKL int 
ECKM int 
EcKN int 


EcKP int 
EcKQ 

EcKR int 
EcKS int 
ECKT int 


ECKV 

EcKX int 
EcKY int 
EcKZ int int int 
EcLB int 


EcLC int 
EcLE 

ECLF xy 
EcLG xy 
EcLH xy 


EcLI int int int 
EcLJ int 
EcLK int 
EcLL int 
EcLM int 


ECLP xy int 
EcLS int 
EcLT string 
EcLV int 
EcCLX xy 


EcLZ 

EcMA real 

EcMB int int 
EcMC int int int 
EcMD int int int int 
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Table C-1 (cont) 


ESCAPE SEQUENCE COMMAND SUMMARY 


Command 


REPORT-DEVICE-STATUS 
RENAME-FILE 

SPOOL 
SET-USER-NUMBER 
SAVE 


ENABLE-DIALOG-AREA 
CANCEL 
DEFINE-MACRO 
SET-ECHO 

LFCR 


HARDCOPY 
IGNORE-DELETES 
LOCK-KEYBOARD 
SET-MARGINS 
RENEW-VIEW 


SET-PAGE-FULL-ACTION 
REPORT-ERRORS 

CRLF 
SET-SNOOPY-MODE 
SET-ERROR-THRESHOLD 


RESET 

EXPAND-MACRO 
SET-KEY-EXECUTE-CHARACTER 
SET-EDIT-CHARS 
SET-DIALOG-AREA-BUFFER-SIZE 


SET-DIALOG-AREA-CHARS 
END-PANEL — 

MOVE 

DRAW 

DRAW-MARKER 


SET-DIALOG-AREA-INDEX 


SET-DIALOG-AREA-ALTERNATE-INDEX 


INCLUDE-COPY-OF-SEGMENT 
SET-DIALOG-AREA-LINES 
SET-DIALOG-AREA-WRITING-MODE 


BEGIN-PANEL-BOUNDARY 
SET-DIALOG-AREA-SURFACE 
GRAPHIC-TEXT 
SET-DIALOG-AREA-VISIBILITY 
SET-DIALOG-AREA-POSITION 


CLEAR-DIALOG-SCROLL 
SET-GRAPHTEXT-SLANT 
SET-BACKGROUND-INDICES 
SET-GRAPHTEXT-SIZE 
BEGIN-FILL-PATTERN 


Setup Command 


None 
RENAME 
SPOOL 
USERNUMBER 
SAVE 


DAENABLE 
None 
DEFINE 
ECHO 
LFCR 


None 
IGNOREDEL 
LOCKKEYBOARD 
None 

RENEW 


PAGEFULL 
None 

CRLF 
SNOOPY 
ERRORLEVEL 


None 

None 
KEYEXCHAR 
EDITCHARS 
DABUFFER 


DACHARS 
None 
None 
None 
None 


DAINDEX 
DA2INDEX 
None 
DALINES 
DAMODE 


None 
DASURFACE 
None 

DAVIS 
DAPOSITION 


None 
None 
None 
None 
None 
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Escape Sequence 


ECME 
EcMF int 
EcMG int 
EcMI int 
EcML int 


EcMM int 
EcMP int 
EcMQ int 
EcMR real 
EcMS int int int 


EcMT int 
EcMV int 
EcMW int 
ECNB int 
EcNC int int 


ECND int 
EcNE int-array 
ECNF int 
EcNK int 
EcNL int 


ECNM int 
EcNP int 
EcNQ int 
ENR int int 
EcNS int-array 


EcNT int-array 
EcNU int 
EcOB int 
EcOC int int 
EcOD int 


EcOE int int 

EcOH int-array int-array 
EcOL int 

EcOM int int 

ECON int-array int-array 


EcOP int int int int 

EcOS int int 

EcOT int 

EcPA string string string 
ECPB string int int 


EcPC string string string 
ECPE string int-array 
ECPF string int int int 
EcPI string int int 

EcPL string string 
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Table C-1 (cont) 


ESCAPE SEQUENCE COMMAND SUMMARY 


Command 


END-FILL-PATTERN 
SET-GRAPHTEXT-FONT 


SET-GRAPHICS-AREA-WRITING-MODE 


SET-PICK-ID 
SET-LINE-INDEX 


SET-MARKER-TYPE 
SELECT-FILL-PATTERN 
SET-GRAPHTEXT-PRECISION 
SET-GRAPHTEXT-ROTATION 
SET-PANEL-FILLING-MODE 


SET-TEXT-INDEX 
SET-LINE-STYLE 
SET-LINE-WIDTH 
SET-STOP-BITS 
SET-EOM-CHARS 


SET-TRANSMIT-DELAY 
SET-EOF-STRING 
SET-FLAGGING-MODE 
SET-BREAK-TIME 
SET-TRANSMIT-RATE-LIMIT 


PROMPT-MODE 
SET-PARITY 
SET-QUEUE-SIZE 
SET-BAUD-RATES 
SET-PROMPT-STRING 


SET-EOL-STRING 
SET-BYPASS-CANCEL-CHAR 
ARM-FOR-BLOCK-MODE 
SET-BLOCK-CONTINUE-CHARS 
SET-DUPLEX-MODE 


SET-BLOCK-END-CHARS 
SET-BLOCK-HEADERS 
SET-BLOCK-LINE-LENGTH 
SET-BLOCK-MASTER-CHARS 
SET-BLOCK-NON-XMT-CHARS 


SET-BLOCK-PACKING 
SET-BLOCK-LENGTH 
SET-BLOCK-TIMEOUT 
PORT-ASSIGN 
SET-PORT-STOP-BITS 


PORT-COPY 
SET-PORT-EOF-STRING 
SET-PORT-FLAGGING-MODE 
MAP-INDEX-TO-PEN 

PLOT 


ESCAPE SEQUENCE COMMANDS 


Setup Command 


None 
None 
GAMODE 
None 
None 


None 
None 
None 
None 
None 


None 

None 

None 
STOPBITS 
EOMCHARS 


XMTDELAY 
EOFSTRING 
FLAGGING 
BREAKTIME 
XMTLIMIT 


PROMPTMODE 
PARITY 
QUEUESIZE 
BAUDRATE 
PROMPTSTRING 


EOLSTRING 
BYPASSCANCEL 
BLOCKMODE 
BCONTINUECHARS 
DUPLEX 


BENDCHARS 
BHEADERS 
BLINELENGTH 
BMASTERCHARS 
BNONXMTCHARS 


BPACKING 
BLENGTH 
BTIMEOUT 
PASSIGN 
PBITS 


PCOPY 
PEOF 
PFLAG 
PMAP 
PLOT 
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Escape Sequence 


ECPM string int-array 
EcPP string int 

EcPQ string 

EcPR string int 

EcQB mt 


EcQD int 
EcQN int 
EcQoO int 
Ecaa 

EcQR int 
EcRA int int int 


ECRB int 
ECRC int 
EcRD int-array 
EcRE int 
ECRE int 


ECRG int int-array 
ECRH xy 

EcRI int-array 
EcRd int 

EcRK int 


EcRL int-array 
EcRN int-array 


~~~ EcRP int char-array 


EcRQ int-array 
ECRR xy xy int 


EcRS xy xy 
ECRT int int int 
EcRU int int int 
EcRV xy xy 
EcRW xy xy 


EcRX int xy xy xy 


EcSA int int-array int-array 


EcSC 
EcSB 
EcSD int int 


EcSE int 

EcSG int int int 

EcSH int int 

EcS1 int real real real xy 
EcSK int 


ESL int-array int-array 
EcSM int int 

EcSN 

EcSO int 

EcSP xy 
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Table C-1 (cont) 


Command 


SET-PORT-EOL-STRING 
SET-PORT-PARITY 
REPORT-PORT-STATUS 
SET-PORT-BAUD-RATE 
SET-COLOR-COPIER-DATA-RESOLUTION 


SELECT-HARDCOPY-INTERFACE 
SET-NUMBER-OF-COPIES 
SET-IMAGE-ORIENTATION 
REPORT-COLORHARDCOPY-STATUS 
SET-COLOR-COPIER-RESERVE-STATUS 
SET-VIEW-ATTRIBUTES 


SET-BACKGROUND-GRAY-LEVEL 
SELECT-VIEW 
SET-SURFACE-DEFINITIONS 
SET-BORDER-VISIBILITY 
SET-FIXUP-LEVEL 


SET-SURFACE-GRAY-LEVELS 
SET-PIXEL-BEAM-POSITION 
SET-SURFACE-VISIBILITY 
LOCK-VIEWING-KEYS 
DELETE-VIEW 


RUNLENGTH-WRITE 
SET-SURFACE-PRIORITIES 
RASTER-WRITE | 
SET-VIEW-DISPLAY-CLUSTER 
RECTANGLE-FILL 


SET-PIXEL-VIEWPORT 
SET-PIXEL-WRITING-FACTORS 
BEGIN-PIXEL-OPERATIONS 
SET-VIEWPORT 

SET-WINDOW 


PIXEL-COPY 
SET-SEGMENT-CLASS 
END-SEGMENT 
BEGIN-LOWER-SEGMENT 
SET-SEGMENT-DETECTABILITY 


BEGIN-NEW-SEGMENT 
SET-GRAPHTEXT-FONT-GRID 
SET-SEGMENT-HIGHLIGHTING 
SET-SEGMENT-IMAGE-TRANSFORM 
DELETE-SEGMENT 


SET-CURRENT-MATCHING-CLASS 
SET-SEGMENT-WRITING-MODE 
BEGIN-HIGHER-SEGMENT 
BEGIN-SEGMENT 
SET-PIVOT-POINT 
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Setup Command 


PEOL 
PPARITY 
STATUS 3PPI 
PBAUD 
HCDATARES 


HCINTERFACE 
HCCOPIES 
HCORIENT 
None 
HCRESERVE 
None 


None 
None 
None 
None 
FIXUP 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 


4115B OPERATORS 


Escape Sequence 


EcSQ int char-array 
ECSR int int 

EcSS int int 

EcST int int 

EcSU 


=cSV int int 

EcSX int xy 

EcSZ int int 

EcTB int int int 
EcTG int int-array 


ECTM int int 
Ec%! int 
ECUB int 
ECUR xy-array 
EcUW xy xy 
EcUX int int 
E.S 


C~B 


ECUs 


ECy 
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Table C-1 (cont) 


ESCAPE SEQUENCE COMMAND SUMMARY 


ESCAPE SEQUENCE COMMANDS 


Command Setup Command 
REPORT-SEGMENT-STATUS None 
RENAME-SEGMENT None 
SET-SEGMENT-DISPLAY-PRIORITY None 
BEGIN-GRAPHTEXT-CHARACTER None 
END-GRAPHTEXT-CHARACTER None 
SET-SEGMENT-VISIBILITY None 
SET-SEGMENT-POSITION None 
DELETE-GRAPHTEXT-CHARACTER None 
SET-BACKGROUND-COLOR None 
SET-SURFACE-COLOR-MAP CMAP 
SET-COLOR-MODE CMODE 
SELECT-CODE CODE 
SET-DRAW-BOUNDARY-MODE None 
DRAW-REC TANGLE None 
SET-OVERVIEW-WINDOW None 
SET-COORDINATE-MODE None 
ENABLE-4010-GIN None 
ENTER-ALPHA-MODE None 
ENTER-BYPASS-MODE None 
ENTER-VECTOR-MODE None 
ENTER-MARKER-MODE None 
PAGE None 
REPORT-4010-STATUS None 
SET-ALPHATEXT-FONT None 
SET-ALPHATEXT-FONT None 
SET-4014-LINE-STYLE None 
4010-HARD-COPY None 
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Appendix 


ASGIl CHARTS 


This appendix includes a standard ASCII code chart and The code charts are: 


additional ASCII code charts which define the specific char- 


alae Tabl 
acters used as parameters (indicated by unshaded areas). eal 


D-1 
D-2 
D-3 
D-4 
D-5 
D-6 


Table D-1 


Description 

ASCII Code Chart 

Characters Used in Char Parameters 
Characters Used in Int Parameters 
Characters Used in Int-Report Parameters 
Characters Used in Xy Parameters 
Characters Used in Xy-Report Parameters 


ASCII (ISO-7-US) CODE CHART 


17 8a 


82 
83 


29 


| F. | F Zz 
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4665-42 


D-1 


ASCli CHARTS 


D-2 


| Bits 
[84 B3 B2 Bl 


Table D-2 


CHARACTERS USED IN CHAR PARAMETERS 


FIGURES UPPERCASE | 


4665-43 
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ASCH CHARTS 


Table D-3 


CHARACTERS USED IN INT PARAMETERS 


Hil Characters Lol Characters 


fae Lo ne a ee ee ee 
7 0 i i/ () 0 () 0) 1 1 1 md 
Be Q) Q ) | | 
om B% Grete ! a ia | ey "6 | 1 Y | ae "9 | 1 
< spe =<. -—-- 4-—--- .—- oe -- whe - mete - wo - Ss rs os BITS we twee -— -4--- Se is - -- * ~ 4 : - ooo 
outs CONTROL UPPERCASE sate CONTROL FIGURES UPPERCASE | LOWERCASE 
4 B4 BY BI | Ba B4 BZ BI 
ae io | \ 
pojojojot Ny D 1p ‘| 
‘, + obs t { 1 ene ne df ee 
olololt Sy D de G 
ee ae se W? 11a 
ClO Sy , Dy 
Ns 
hak rae (ean Si premtleectas emreed "oie vel . =F pi ok % 
Oran 4 Ey De 
lol1iolo Ey | D 
hoitioli] E Ny 
| | Q ; K 
4 » Berea e Elles eee ares ee af - eye gaten 
Oisrio Ay Sy 
; 8 ? 
oo fo Sere ares e ee 
rion al By ER 
ar re ee fa nee ha “en S c es 
110lo lo Be Cy 
& 
pale) Cooma Onis at 
1010/1 Hy | EN 
a 
11011]0 Le | Sp 
sit oetle s s oo 8 ORT. 
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ASCII CHARTS 


Table D-4 


~ CHARACTERS USED IN INT-REPORT PARAMETERS 


Hil-Report Characters 


) 0, Q 0 1 1 1 1 


CONTROL | rigures | UPPERCASE 


LOWERCASE 


12 


aS 


meme 6 
—_ _ 
S So 
D Qn 
~ 
Wr) 
% 


= 
co 


108 


09 


¢ 
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Lol-Report Characters 


@ 0, Q Q 
Pe el tel] al 


el, 
ee 


Nae Wises (6 
cD hae om) caf a 
2 
~ 


a ea lace ie ass 
oe 


Go) 
ioe) fee) 
& ~N ie>) 
7 oQ 
= 


N 
j=) 
lee} 
~ 
S 
Nh 
~ 
(ee) 


N 
~ 


ol ee 
N 


73 89 105 1214 


rm] ong 


\ | | 


m 
9 10 12 


/\ no |™w 


N 
(@) 


— 
© 
w N 
3 
WH 
On 


z= 


~ 
~~ 
i=) 
~ 
NO 
i) 


Dy 


12 


q 

© 

a 
Oo 


a 
Perry Sd 8. 


95 


N 
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ASCII CHARTS 


Table D-5 


CHARACTERS USED IN XY PARAMETERS 


HiY, HiX Characters 


1 
UPPERCASE | LOWERCASE 


LoX Characters 
0 1 1 
ea ee ee 
FIGURES UPPERCASE 
p | 0 |-@erep 
32 GOL aes ad| B01 >. 96} tie 
1 RSARee a 
33) 49 [io BLY gf 97 | ae 
i 2. 2B ce b r 
34} 50 “5 OB} 82 98 tt4 
# | 3) BS Geop We Gis 
35} 5a} carl 83 99| 115 
$ A PD aS d t 
; 36 D2 FRE pal” 84 100 116 
od a we ae 2 
% 5. we e u 
32) 53 : 101 117 
& 6 | f V 
38 aye 102] 118 
: ame g W 
be at I oa Pe 103] 119 
( 8 h X 
40} 5 104 120 
pale oo | y 
eae 105 121 
* | Z 
42| 106| 122 
+ : k { 
43) 107] 123 
ae | | 
44 108 124 
a Oi 7 
~— = } 
45 109 125 
e. n N 
46 110} 126 
y ? 0 D 
47 111 Toe 
4665-46 
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ASCII CHARTS 


D-6 


Table D-6 


CHARACTERS USED IN XY-REPORT PARAMETERS 


BITS 
[84 B3 B2 Bl 


ae Pe a 
Inu 


126] 


roth too 
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OPTIONAL KEYBOARDS 


The following optional keyboards are available for the termi- OPTION 4A: UNITED RINGDOM 


nal. For information on how to install these optional key- KEVRBOARD 
boards, see the 4//5B Service Manual. The viewing keys 


SNe OWN Ce Se cmos howe iW lvene Dearvelie This option permits the terminal to change to a United King- 


dom keyboard layout so that the United Kingdom characters 
are displayed. The only change is that the “#’’ sign is 
replaced by the English “£” sign. When this key is pressed 
(or the appropriate code received by the terminal), the “f£”’ 
sign is displayed on the screen. The revised keyboard con- 
figuration is shown in Figure E-1 and the revised ASCII code 
chart is shown in Table E-1. 


CLEAR CANCEL | 


KYBD PAGE | 0 O O 
LOCK — FULL XMT RCV | 
oa C3 Co | 


DIALOG SETUP LOCAL HARD 
AREA COPY 


tions. 


4665-52 3} 


Figure E-1. United Kingdom Keyboard. 
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OPTIONAL KEYBOARDS 


E-2 


Table E-1 
UNITED KINGDOM CHARACTER SET 


HIGH X & Y 
B4 B3 B2 Bl POM eBOE GRAPHIC INPUT LOW X LOW Y 


BITS 


Hae Oe ad 
lolol TSH Oot al Fol Mel Cul Fol Sl 
Pel a Mead ad Pol Bal Bad Pad 
le aoe 


[ oe 
ripe Pac) 8 4 Oe Tp a 
td A 


poe ae Bal Op ia does 
ate Bel fod Fol Oo] Wel Bed Mie 
Petts of ag Cl Pad Hag ad Oa Yo 
PP Mr Baal Pal Bal al Val lad Ye 
cn 


is : 
rere l= = Ml sol Mad 
RETURN13 29 61 77 93 109 125 
ee ee oa EEG 
HP] 80. * 
Sh id 2 ah ak ad ml il 
PoP il Sy ad 
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OPTION 4C: SWEDISH KEYBOARD 


This option changes the standard keyboard configuration to 
a Swedish layout and allows Swedish characters to be dis- 
played. There are 17 changes to the keyboard, with three of 
these changes being new alphabet characters. When these 
seventeen keys are pressed (or the appropriate codes are 
received by the terminal), the corresponding characters are 
displayed on the screen. The revised keyboard configura- 
tion is shown in Figure E-2 and the revised ASCII code chart 
is shown in Table E-2. 


FA F2 F3 F4 F5 F6 F7 F8 


OPTIONAL KEYBOARDS 


OPTION 4F: DANISH/NORWEGIAN 
KEYBOARD 


This option changes the standard keyboard to a Danish/ 
Norwegian layout so that the Danish/Norwegian characters 
are displayed. There are 17 changes to the keyboard, with 
three of the changes being new alphabetic characters. 
When these 17 keys are pressed (or the appropriate codes 
are received by the terminal), the corresponding characters 
are displayed on the screen. The revised keyboard configu- 
ration is shown in Figure E-3 and the revised ASCII code 
chart is shown in Table E-3. 


CLEAR CANCEL 


CLL 


re SETUP LOCAL eae 


KYBD PAGE 
LOCK FULL 


es yu 
re felelsietrlelslshe 


(eel low ZI x fc flv BN JM) 


SHIFT BREAK 
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Figure E-2. Swedish Keyboard. 


FI F2 F3 FA F5 Fe F7 F8 


rs elalsforrfebelste 
(eal ovr fz J flo Lv JCB LN i) 


CLEAR CANCEL 


KYBD PAGE 
LOCK FULL XMT ~~ RCV 
Cc CS) Cc Cc 


na SETUP LOCAL Snay 
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Figure E-3. Danish/Norwegian Keyboard. 
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OPTIONAL KEYBOARDS 


E-4 


Table E-2 
SWEDISH CHARACTER SET 
1 Tra 
BITS : 
HIGH X& Y 
ipa B3 B2 BI CONTROL GRAPHIC INPUT LOW X LOW Y 


ages 8 


SPAG 


seh] Ar Ee) al 9 ae 
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; 

jolt fr qT 11 C 27 75] | 
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OPTIONAL KEYBOARDS 


Table E-3 
DANISH/NORWEGIAN CHARACTER SET 


HIGH X & Y¥ 
GRAPHIC INPUT 


CONTROL 
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OPTIONAL KEYBOARDS 


OPTION 4K: KATAKANA KEYBOARD 


This option enables selection of either English or Katakana 
characters for entry and display. The key in the lower left 
hand corner (Caps Lock, on the standard keyboard) con- 
trols character set selection. Pressing this key toggles the 
character set. The keycap light indicates the active charac- 
ter set: on indicates Katakana character set and off indi- 
cates English character set. The Caps Lock function is 
moved to the unshifted SETUP key and only has an effect 
with the English character set. Shift-SETUP is required to 
select setup mode. Setup mode only has meaning with the 


F1 F2 F3 F4 F5 F6 F7 F8 
@ (, 
pace] | 28 | [3% | [3% | [s%e] °x fe + [7 &+] o a" =| 2 ps a, 7 The 
NX 


fe AI 
SeoRvEaBee 


English character set; therefore, setup mode selection 
causes the English character set selection. Pressing the 
Break key also causes English character set selection. The 
SETUP key light indicates both caps lock and setup mode in 
the following manner: 


off no setup mode and no Caps lock 
on (steady) no setup mode and caps lock 
on (fast blink) setup mode and no caps lock 
on (slow blink) | setup mode and caps lock 


The revised keyboard configuration is shown in Figure E-4 
and the revised ASCII code chart is shown in Table E-4. 


SETUP 
CLEAR (BLINK) CANCEL 


es 3 LL LL 
LOCK FULL XMT RCV 


DIALOG CAPS LOCAL HARD 
AREA LOCK COPY 
(STEADY) 


. " 
BERR Eee : 
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Figure E-4. Katakana Keyboard. 
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Table E-4 
KATAKANA CHARACTER SET 
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EXAMPLES OF OPERATION 


The following seven examples will help you become familiar 
with some of the features of your terminal. You don’t need to 
go through all of the examples in one sitting or do all of them 
in the order in which they are shown. However, whenever 
you work through any of them, you should do Example 1 
first, since it sets up the terminal so that the examples will 
work as shown. You will also need to do Example 4 (in which 
segmenis are created) before Examples 5 or 6 (in which the 
segments are manipulated). 


These examples provide a few simple and quick exercises 
to familiarize you with the terminal. Therefore, most com- 
mands are used with very little explanation. References are 
made to the manuals where complete explanations can be 
found. These examples are also found in the brochure 
Introducing Your 4115B Computer Display Terminal.The 
command words for all setup commands are completely 
spelled out in the examples. They can, however, be abbrevi- 
ated to as few characters as necessary to distinguish them 
from other commands (usually two or three characters). 


4115B OPERATORS 


Setup commands are shown in uppercase Characters So 
they can be easily distinguished from the rest of the text. 
However, setup commands can be entered in uppercase or 
lowercase. You can use the Caps Lock key (press It so the 
light in it is on) to cause all alphabetic characters to be 
uppercase. 


Escape sequence commands used in Setup mode (as in 
Examples 4-7) must be entered in uppercase, as shown. 


In several examples, you are told to /ogg/e the DIALOG key. 
That means to press the DIALOG key once to turn the dialog 
area off, and then press it again to turn the dialog area back 
on. 


REV, JAN 1984 F-1 


EXAMPLES OF OPERATION 


EXAMPLE 1 — GETTING READY 2. 


Do this example before doing any of the others, since it sets 
up the terminal so examples will operate as described. 


1. Ifthe power is already on, skip to Step 2. 


If the power is not already on, press the POWER switch 
(Figure F-1). A green indicator is visible in the switch 
when you release it; the lights in the keyboard blink on 
and off as the terminal goes through the power-up pro- 
cedure, during which it tests certain parts of itself to be 
Sure it is ready for operation. In about 15 seconds, the 
screen is erased and the cursor appears. If an error 
message is displayed or the cursor does not appear, 
See Appendix B. 


Go to Step 3. 


3. 


Do this if the power is already on. Press the MASTER 

RESET button (Figure F-2). The terminal goes through 
the power-up self-test procedure. Within about 15 sec- 
onds the screen erases and the cursor appears on the 


screen. 


So that the examples in this brochure will execute as 
shown, reset the terminal to its factory default operat- 
ing environment. To reset it, do the following: 


Figure F-1. The POWER Switch. 
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Figure F-2.The MASTER RESET and SELF TEST Buttons. 
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Press and hold the SELF TEST button. 


Continue to hold SELF TEST while you press and 
release the MASTER RESET button. 


Release the SELF TEST button. 


The indicator lights in the keyboard flash and ina 
few seconds the terminal bell rings. Within 20 sec- 
onds after the bell rings, enter Ctrl-C: That is, press 
and hold down the Ctrl key while you press and 
release the C key, then release the Ctrl key. Within 
about 15 seconds, a menu appears on the screen 
(Figure F-3A). 


e. Press the key labeled F2. Another menu (Figure F- 
3B) appears. CMOS is an acronym for the kind of 
memory used to store the terminal’s operating 
environment. 


f. Press the key labeled F1. The message shown in 
Figure F-3C is displayed below the menu. CMOS 
Reset means that the operating environment has 
been reset to its factory default condition. 


g. Nowenter Ctrl-E. In afew seconds, the screen is 
erased and the cursor appears again. 


Figure F-3. Self Test Menus. 
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4. Press the DIALOG key (Figure F-4). Tne light in the key 
comes on and the dialog area Decomes visible. Even 
though it is visible, you can’t see anything in it since it 
has not yet been enabled. 


5. Press the SET UP key (Figure F-4). The light in the key 
comes on and an asterisk appears at the left margin, 
next to the cursor. 


EGAN SS 


CONVERGE | 


6. Enter the following setup command to enable the dia- 
log area (the “rR means press the Rtn key, Figure F-4). 


DAENABLE YES Cr 


INTENSITY 


Now that tt is both visible and enabled, the cursor and 
asterisk appear in the dialog area. 


7. The brightness of the display is controlled by the 
INTENSITY control (Figure F-5). Turn the knob to the 
right to make the display brighter, to the left to make it 
dimmer. Set the brightness to a desirable level. 


8. Press the Page key (Figure F-4). This erases the part of 
the screen that is not displaying the dialog area. The 
dialog area is not erased. 


Figure F-5. INTENSITY Control. 


9. Press the CLEAR key (Figure F-4) by pressing Shift and 
DIALOG at the same time. This erases the dialog area 
but has no effect on the non-dialog portion of the 
screen. 


Now the cursor is blinking on the first line of the dialog 
area, but nothing else is on the screen. 


DIALOG/CLEAR 


SET UP 


Page 


4665-58 


Figure F-4. Page, DIALOG/CLEAR, SET UP, and Rtn keys. 
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EXAMPLE 2 — MANIPULATING THE 
DIALOG AREA 


Do Example 1 before doing any of the others, since it sets 
up the terminal so examples will operate as described. 


This 
man 


example introduces some of the commands used to 
ipulate the dialog area. It also includes other general 


setup commands, how to adjust the brightness level, and 


how 


to use the thumbwheels to view the contents of the dia- 


log area. 


ie 


The STATUS setup command reports all or part of the 
current terminal operating environment. This example 
illustrates various forms of the STATUS command. 
Enter the following STATUS command for a report (Fig- 
ure F-6) of which keys are assigned for editing. 


STATUS EDITCHARS ©r 


The report lists three characters, the first of which rep- 
resents the terminal’s character-delete character. The 
box means that the current character-delete key is Rub 
Out. If you make a mistake when typing a setup com- 
mand, press the Rub Out key to back up along the cur- 
rent line. Characters are deleted as the cursor 
backspaces. 


The second character is the /ine-delete key. The °n 
means the ASCII cancel character is currently the line- 
delete character (this is not the same as the CANCEL 
command key). If you want to delete an entire line, type 
the cancel character by entering Ctrl-X. The cursor 
moves back to the beginning of the line, erasing the 
entire line as it does so. 


The third character in Figure F-6 is called the /iteral 
character. \t is discussed in Example 3. 


Figure F-6. STATUS EDITCHARS Report. 
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2. Enter the following command for a status report on all The dialog area is set to display five lines at a time; 
communications parameters (the result of the com- since the status report is more than five lines long, you 
mand is shown in Figure F-7). cannot see all of it. 


STATUS COMMUNICATIONS ©r 


Figure F-7. Result of STATUS COMMUNICATIONS Command. 
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Rotate the right thumbwheel (Figure F-8) down to scroll 
through the dialog area so you can examine the rest of 
the contents of the dialog buffer. 


3. Enter the following command to increase the visible 
portion of the dialog buffer: 


DALINES 20 ©r 


Toggle the DIALOG key; now 20 lines of the dialog 
buffer are visible (Figure F-9). 


Figure F-8. The Thumbwheels. 


45 TATUS COMMUNICATIONS 
COMMUNICATIONS 


Figure F-9. Adjusted Dialog Display of STATUS COMMUNICATIONS Report. 
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4. The following commands affect the dialog area by 5. To change the dialog area back to its previous orienta- 
reducing the length of lines and relocating It. Toggle the tion, enter the following commands and then toggle the 
DIALOG key after entering these commands to update DIALOG key: 
the dialog area. DALINES 5 Cr 

DACHARS 25 ©r DAPOSITION 00 ©r 

DAPOSITION 1000 1000 °r DACHARS 80 ©r 
The factory default dialog area is located such that its 
lower-left corner is at the lower-left corner of the screen 6. Press the Page and CLEAR keys to erase the entire 
(0,0). It is now relocated (Figure F-10) so that the dialog screen. 


area’s lower-left corner is at point (1000,1000). 


*DALINES 2c 
*DACHARS 25S 


=DAPOSITION 1684 1648 


- 
= 


4665-61 


Figure F-10. Relocated Dialog Area. 
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EXAMPLE 3 — PROGRAMMING 
KEYS 


Do Example 1 before doing any of the others, since it sets 
up the terminal so examples will operate as described. 


Most keys can have one or two macros (character strings 
and/or commands) programmed into them. When a macro 
is programmezd into a key, the key is expanded to generate 
that macro when you press it. 


1. 


F-10 


Enter the following command to increase the visible 
extent of the dialog area and then toggle the DIALOG 
key to update the dialog area: 


DALINES 20 ©r 


Enter the following command to program the key 
labeled F1 to mean “STATUS EDITCHARS”: 


DEFINE F1 ‘STATUS EDITCHARS’ ©r 


In this command, be sure to type in the characters “F’’, 
“4” This DEFINE command creates a macro and asso- 
ciates it with key F1. There are many variations of the 
DEFINE command. See Section 6 for details. 


Press the key labeled F1. The alphabetic string “STA- 
TUS EDITCHARS” appears on the screen. 


Now press the Rtn key and the terminal executes the 
STATUS EDITCHARS command. 


Notice the third character in the edit character report 
(Figure F-11). This is called the literal character. 


The literal character is used when you want to include 
in a macro a character that would normally be exe- 
cuted, such as a carriage return. For example, a key 
can be programmed to not only display a character 
string, but to execute that command because a car- 
riage return is included in the macro. 


To program the key labeled F2 to display and execute 
the STATUS EDITCHARS command, enter the follow- 
ing: 

DEFINE F2 ‘STATUS EDITCHARS ~ ©r’ ©r 


When you type the literal character, it is displayed; 
when you press the Rtn key, the cursor backspaces and 
types ©r over the literal character. Type a single closing 
quote to end the macro and then press Rtn again to ter- 
minate the command. 
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Now press the Key labeled F2; the terminal executes 
the STATUS command. Figure F-11 shows the result of 
that command as well as the entire sequence of com- 
mands in this example. 


To delete all macros currently programmed into the 
keys, enter the DEFINE command in the following form: 
DEFINE ALL Sr 


Macros are also deleted when the terminal is turned off 
or reset. 


Reduce the visible extent of the dialog area to five lines 
by entering the following command and then toggling 
the DIALOG key: 


DALINES 5 ©r 


Press the Page key and then the CLEAR key to erase 
the screen. 


Figure F-11. Results of Programming a Key. 
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EXAWIPLIE 4 — 
ENTERING GRAPHICS AND ESCAPE 
SEQUENCE COMMANDS 


Do Example 1 before doing any of the others, since it sets 
up the terminal so examples will operate as described. 


This example introduces four concepts: 

© Use of escape sequence commands in Setup mode 
© Local graphics 

© Color graphics 


© Panels 


Graphics are typically generated by a host-resident pro- 
gram, and escape sequence commands will not generally 
be used locally. However, there may be times when you 
want to create graphics locally, as illustrated in this exam- 
ple. This is also an easy way to create the segments used in 
Examples 5 and 6. 


1. Enter the following series of escape sequence com- 
mands exactly as shown. Press the key labeled Esc to 
enter the -c character. The next two characters are the 
command op-code; these must be entered in upper- 
case; there is no space between the first three charac- 
ters. Then enter a Space and the numeric parameters 
with a space between each parameter (except the last 
command, which has no parameter). Terminate each 
command with a carriage return. 


There is no visible result for the first three commands. 
The series of commands draws the frame of a house 

(defined as a panel) and fills tt with a blue color. Figure 
F-12A is a black and white representation of the result. 


EcmS000°R 

EcMP —4 rR 

EcSO 1°R 

ECUR 1000 750 2500 1500 °r 
EcSC Sr 


A panel is simply an enclosed area. The first command 
in the preceding sequence specifies how the terminal 
will fill in panels. The second command specifies that 
the panel should be filled with blue. The third command 
opens a segment named 1. That means that all subse- 
quent commands become part of Segment 1, continu- 
ing until Segment 1 is closed. The fourth command 
draws a rectangle with lower left corner at (1000, 750) 
and upper right corner at (2500,1500). The last com- 
mand closes Segment 1 and then the panel is filled. 


4115B OPERATORS 


EXAMPLES OF OPERATION 


After you have entered these commands, press the 
Page key. Pressing Page permanently erases vectors 
that are not part of asegment. Vectors included ina 
segment are erased briefly and then redrawn. 


If you make a mistake entering the coordinates, the ter- 
minal draws to the wrong point. If that happens, you 
should close the segment, delete the segment, open 
another segment with the same name, and start over. 


For example, if you made a mistake in drawing Seg- 
ment 1, delete it and start over by entering the following 
commands: 


EcSC CR 
EcSK 1°R 


The first command closes the open segment and the 
second command deletes it from the terminal's mem- 
ory. Then go back to Step 1 and enter the correct com- 
mands. 


The following series of commands draws the roof out- 
line and then fills in the roof with a cyan color (Figure 
F-12B). Note the action of each LG command. 


EcMP —5 Cr 

EcSO 2°r 

EcLP 900 1435 1 CR 
EcLG 1750 2000 Sr 
EcLG 2600 1435 ©r 
EcLE Cr 

EcSC Sr 
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4. This next series of commands draws the left window of 
the house (Figure F-12C). The first command specifies 
the panel filling color to be green. The second com- 
mand opens Segment 3; the third draws the rectangle; 
the fourth closes the segment. 


EcMP —3 ©r 

EcSO 3°rR 

ECUR 1100 950 1300 1200 Cr 
EcSC Cr 


The door, filled with red (Figure F-12D): 


EcMP —2 Cr 

EcSO 4°r 

ECUR 1425 750 1675 1200 ©r 
Ecsc Sr 


And finally the right window, filled with white 
(Figure F-12E): 


EcMP —1 °r 

EcSO 5 Cr 

ECUR 1800 950 2400 1200°r 
EcSC &r 


5. Press the Page and CLEAR keys. This erases vectors 
from the screen that are not saved in segments and 
erases the dialog area. | 


Figure F-12. Graphic Displays Created by Escape Sequence Commands. 
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EXAMPLE 5 — WANIPULATING A 
SEGMENT AND USING VIEWING 
KEYS 


Do Example 1 before doing any of the others, since it sets 
up the terminal so examples will operate as described. The 
segments used in Example 5 are created in Example 4. 


There are many ways to manipulate segments. Steps 1 and 
2 illustrate ways segments would normally be manipulated 
by a host program. See the 4//0 Series Command Reference 
Manual and 4/10 Series Host Programmers Manual for 
details. 


Steps 3-9 illustrate how to use the ZOOM, PAN, VIEW, and 
RESTORE keys. All of the viewing keys are explained in 
Section 2 of this manual. 


Figure F-13. Display with Invisible Segment. 


1. Make the right window of the house invisible by enter- ey eh ge 
ing the following command: gene gus emt e egeeabsredsni . seieeleeiwebibonas 


EcSV50°R 


Press the Page key. The segment containing the frame 
of the house is not deleted from memory, but it is no 
longer visible on the screen (Figure F-13). 


Make it visible again by entering the following com- 
mand and then pressing the Page key. 


EcSV51£R 


2. You can highlight the house’s door with the following 
command. The terminal highlights the door by blinking 
it off and on. ee 


E Cc 
CSH41°R Figure F-14. The Viewing Keys. 


Turn the highlighting feature off by entering the follow- 
ing command: 


EcSH40°CR 


3. Press the SET UP key to exit from Setup mode. Press 
the DIALOG key to make the dialog area invisible. 


4. Press the ZOOM key (Figure F-14) to make the zoom 
function of the viewing keys active. A framing box 
appears at the edge of the screen, with the lower-left 
and upper-right corners of a rectangle in the center of 
the box (Figure F-15). 
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Figure F-15. Display with Framing Box for ZOOM. 
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Rotate the top thumbwheel down or the bottom 
thumbwheel to the left to decrease the size of the fram- 
ing box, as shown in Figure F-16. 
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Figure F-16. Adjusted Framing Box for ZOOM. 
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5. Press the PAN key to make the pan function of the view- When you rotate the top thumbwheel up or down, the 
ing keys active. The framing box remains on the screen framing box moves up or down. When you rotate the 
in the same position, but it now has across in its center bottom thumbwheel to the left or right, the framing box 
(Figure F-17). moves to the left or right. 


Figure F-17. Framing Box with Crosshair for PAN. 
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In Figure F-18, the framing box has been repositioned. 


4665-66 


Figure F-18. Repositioned Framing Box for PAN. 
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6. Use acombination of zooms and pans to position the then the pan function to position the box. You can use 
framing box as shown in Figure F-19. First use the either function alternately by pressing the appropriate 
zoom function to make the box the appropriate size, Key. 


Figure F-19. Framing Box After ZOOM and PAN. 
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When you have the box positioned, press the VIEW key 
(Figure F-14). The view is updated to display just the 
contents of the framing box (Figure F-20). 


Press the RESTORE key (Figure F-14) by pressing the 
Shift and VIEW keys at the same time. This restores the 
original view. 


10. 
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You can continue to experiment with the ZOOM and 
PAN functions. When you are finished, press the 
OVERVIEW key (Shift-PAN). Then press either the 
ZOOM or PAN key, depending on which one is lit. 


Press the DIALOG key to make the dialog area visible 
again. Press Page and then CLEAR to erase anything 
on the screen that is not saved in a segment. 
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Figure F-20. Display Updated with VIEW. 
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EXAMPLE 6 — USING THE DISK 
DRIVE AND 3PPI 


Do Example 1 before doing any of the others, since it sets 
up the terminal so examples will operate as described. The 
segments used in Example 6 are created in Example 4. 


Example 6 illustrates the use of the optional disk drive and 
the three-port peripheral interface (SPPI). 


NOTE 


Be sure that the disk you use for this example is one 
that does not contain information that you want to 
save. The first step in the example formats the disk, 
which effectively erases any information already — 
stored on it. 


1. Press in on the door bar (Figure F-21) to open the disk 
drive. If the disk you are going to use has a write-pro- 
tect notch, be sure that it is covered. Insert a disk as 
shown in Figure F-22. Press down on the disk drive 
door until it snaps closed. Press the WRITE PROTECT 
switch so that the red light above the switch is off. 


2. Enter the following command: 
FORMAT FO: Cr 


It takes about a minute for the terminal to format the 
disk. During that time, the light in the disk door is on, 
indicating that the disk is operating. When the disk is 
formatted, the light turns off. 


3. Enter the following command to save all existing seg- 
ments into a file named HOUSE. 


SAVE SEG ALL TO FO:HOUSE £r 


B. On the M4115B - 1665-89 
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Figure F-21. Disk Drive Door Bar. 


4115B OPERATORS 


4. 


4115B OPERATORS 


Delete all segments from the terminal’s memory (but 
not from the disk) with the following command: 


EcSK ALL ©r 
Press the Page key. Since the segments are no longer 


stored in terminal memory, they are erased. 


To restore the file containing the house segments, enter 
the following command: 


LOAD FO:HOUSE Cr 


The LOAD command reads the specified file and exe- 
cutes itas acommand file. The house is redrawn as 
five individual segments just as it was before. 


Save each segment into an individual file with the fol- 
lowing commands: 


SAVE SEG 1 TO FO:FRAME °r 
SAVE SEG 2 TO FO:ROOF °r 
SAVE SEG 3 TO FO:LWINDOW Cr 
SAVE SEG 4 TO F0:DOOR ©r 
SAVE SEG 5 TO FO:RWINDOW Cr 


Delete all segments again: 
EcSK ALL ©r 


Press Page to erase the screen. 


Enter the DIRECTORY command for a listing of all files 
on the disk. Use the top thumbwheel to scroll the dialog 
area to observe the directory contents. 


DIRECTORY FO: ©r 


Restore each part of the house individually: 


LOAD FO:FRAWME fr 
LOAD FO:ROOF fr 
LOAD FO:LWINDOW Cr 
LOAD F0:DOOR ©r 
LOAD FO:RWINDOW Cr 
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Figure F-22. Inserting a Disk. 
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10. 


F-22 


The following commands delete individual parts of the 
house. This command deletes the frame of the house: 


EcSK 1 °R 
This command deletes the roof: 

EcSK 2°R 
This command deletes the left window: 

EcSK 3 CR 
This command deletes the door: 

EcSK 4°r 
And this command deletes the right window: 

EcSK 5°r 
If you have the 3PPI and a 4662 or 4663 Plotter, you 
can plot this display. First use an RS-232 cable to con- 
nect the plotter to a 3PPI port. Then assign a device 
driver and set up the port for the plotter. For example, 
the following commands assign the 4663 device driver 


to Peripheral Port 1 and set the port’s parameters so it 
can display a file from the disk drive: 


PASSIGN P1: 4663 r 
PBAUD 1 200 ©r 
PBITS 18 CR 


Set the switches on the back of the 4663 to 2, 2, 2, and 
3, respectively. Now copy the segments on the plotter 
through the 3PPI with the following command: 


COPY FO:HOUSE TO P1: &r 


After the plot is complete, press the Page and CLEAR 
keys to erase the screen. 


EXAMPLE 7—USING GRAPHIC 
INPUT 


Do Example 1 before doing any of the others, since it sets 
up the terminal so examples will operate as described. 


a: 
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Enter the following command for Graphic Input mode 
using the crosshair cursor to locate one point: 


EcIEO1°r 


Press the SET UP key to exit from Setup mode (the 
light in the key should go off). Move the crosshair cur- 
sor by rotating the thumbwheels. The top thumbwheel 
moves the horizontal line of the crosshair, the bottom 
thumbwheel moves the vertical line of the crosshair. 
The intersection of the horizontal and vertical lines is 
the point that is sent to the program. 


Press the Shift key at the same time you rotate a 
thumbwheel. Notice that the cursor moves much more 
slowly. This allows you to be very precise in locating a 
point on the screen. 


Press any alphanumeric key. The terminal transmits the 
point you located. GIN Mode is terminated because it 
was only initialized to locate one point. 


Press the SET UP key again to put the terminal back 
into Setup mode, then enter the following commands: 


EcML 2 Cr 
EcIEO5 Cr 
EcllO1°R 


The first command specifies the line color to be red. 
The second command puts the terminal into GIN Mode 
until you locate five points. The third command initial- 
izes a function called inking. With inking in use, the ter- 
minal draws a line from the last point located to the next 
point you specify. 


Exit from Setup mode by pressing the SET UP key. 
Move the crosshair around the screen and locate (spec- 
ify) a point by pressing an alphanumeric key. Nothing is 
visible when you locate the first point. As you locate the 
next four points, the terminal draws lines between 
them. The crosshair disappears after you locate the 
fifth point. 


To terminate the inking feature, put the terminal back 
into Setup mode and enter the following command: 


Ecli0O&r 
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Press the Page key to erase the graphics area of the 
screen. Now enter the following commands: 


EcNIL 4 °rR 
EcIEO5 Cr 
EcIRO1°r 


The first command specifies the line color to be blue. 
The second command puts the terminal into GIN mode 
until you have digitized five points; the third command 
initializes the rubberbanding feature. The rubberband 
is a line from the last point located that follows the 
crosshair Cursor as It moves. 


Press SET UP to exit from Setup mode. Use the 
thumbwheels to position the crosshair cursor and press 
an alphanumeric key to locate a point. Now when you 
move the cursor again, a line follows the cursor around 
the screen. When you press an alphanumeric key to 
locate another point, the rubberband disappears; as 
you move away from that point again, the rubberband 
again follows the cursor. Repeat until the crosshair 
cursor disappears. 


Put the terminal back into Setup mode and turn rubber- 
banding off by entering the following command: 


EcIR00 CR 
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Press the page key to erase the graphics area of the 
screen. Enter the following commands to change the 
line color to yellow and to put the terminal in GIN mode 
until you have digitized ten points, with both inking and 
rubberbanding in effect: 


ECML 7 °r 
EclIEO 10°R 
Echo 1°r 
EcIRO1&R 


Exit Setup mode by pressing SET UP. 


Move the crosshair cursor around the screen and 
locate ten points. As you move the cursor around, the 
rubberband line follows it. When you press an alphanu- 
meric key to input a point, the rubberband segment is 
“inked in.” 


Press SET UP again to enter Setup mode. Change the 
line color back to white and turn off rubberbanding and 
inking by entering the following commands: 


EcML 1 Cr 
Ech OOCR 
EcIRO0CR 


Press Page and then CLEAR to erase the screen. 
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Appendix G 
COLOR STANDARD 


In the HLS color coordinate system, 420° 60° 
the color space is represented as a 
double-ended cone. 


The HUE coordinate runs 
counterclockwise around the 480° 0° 
cone. (0 to 360 degrees.) 


The LIGHTNESS coordinate runs 
vertically up the cone. (0% to 100%.) 


The SATURATION coordinate runs 
radially outward from the axis of 

the cone. The SATURATION coordinate 
is a percentage of the maximum 

possible saturation at a particular 180° 
LIGHTNESS level. (0% to 100%.) 


HUE 


NOTE: For clarity, this figure 
shows the cone divided into only 
64 colors, as in the TEKTRONIX 
4027 terminal. The 4115B termi- 
nal has a wider repertory of color 
mixtures. 


Figure G-1. The HLS Color Cone. 
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Overview: 


The world of color is filled with ambiguous 
terminology, i.e. intensity, purity, value, etc. 
Many color users feel that “color theory” is a 
prerequisite to operating color systems; T.V., 
Videotaping, Photography, Computer Graph- 
ICS. 


In order to end this confusion, Tektronix has 
developed a color language and function 
based on human engineering, rather than 
machine engineering. Below is a description 
of this system, which will provide a clear 
and concise means for understanding how 
color is defined and how our syntax was 
derived. 


Color Concepts: 


Color selection is specified by hue, light- 
ness and saturation which is the HLS 
method. The definitions are as follows: 


Hue: The characteristic associ- 
ated with a color name 
such as red, yellow, green, 
blue, etc. Hue is a grada- 
tion of color advanced by 
degrees, thus represented 
as an angle from 0 to 360. 


The characteristic that al- 
lows the color to be 
ranked on a scale from 
dark to light. Lightness is 
expressed as a parameter 
ranging from O to 100% 
with black being O (bot- 
tom of cone) and white 
being 100% (top of cone). 


Lightness: 


The characteristic which 
describes the extent to 
which a color differs from 
a gray of the same light- 
ness. Saturation is ex- 
pressed as percentage, 
ranging from 0% (maxi- 
mum white content at that 
lightness level) to 100% 
(full saturated). 


Saturation: 


Geometrically, colors can be described in 
terms of a double cone. 

Variations in lightness are represented 
along the axis, with white at the apex of 

the cone and black at the opposite apex. 
Variations in saturation are represented by 
radial distances from the lightness axis, in 
constant lightness planes. Hue is repre- 
sented as an angular quantity from a known 
reference point. 
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ORDERING INFORMATION 


This appendix contains ordering information for standard OPTIONAL ACCESSORIES 
and optional terminal accessories that will normally be of 

use to an operator. There are other accessories that will be ; 

of use only for servicing and adjustment of the terminal. For For Operation 


those accessories, refer to the parts list in the 4115B Serv- 


ice Manual, Volume 2. Function Key Overlays (Set of 6) 334-3290-02 
Flexible Disks (One-Sided, 
Double Density) 119-1376-01 
Host Port Loopback Connector 067-1043-00 
STANDARD ACCESSORIES 4115B Option 3A DMA Interface 
Instruction Manual 070-4761-01 
4115B Introduction Brochure 070-4663-00 4110 Series F13/14 Graphics Tablet 
4115B Computer Display Terminal Instruction Manual 070-3814-00 
Operators Manual 070-4665-00 119-0977-01/03 Flexible Disk Drive 
4110 Series Host Programmers Manual 070-4664-00 Instruction Manual 070-2504-01 
4110 Series Command Reference Manual 070-3892-00 4925 Dual 5.25-Inch Flexible Disk Drive 
4110 Series Reference Guide 070-4715-00 and 4926 10M Byte Hard Disk Drive 
Power Cord 161-0123-00 Instruction Manual 070-4688-01 
Host Port RS-232 Cable 012-091 1-00 
Function Key Overlays (Set of 6) 334-3290-02 ; 
Display Cables For Service 
BNC cable 012-0074-00 
contro! cable 012-0525-00 4115 Service Manual, Vol. 1 070-4666-00 
4115 Service Manual, Vol. 2 070-4667-00 
M4115B Electronics Module Service 
Manual 070-5007-00 
640-0219-01 Display Module Service 
Manual 070-4668-01 
ECC RAM Service Manual 070-4701-00 
4110F09 (Interface for 4690 Series 
Color Graphics Copiers) 
Service Manual 070-4497-00 
020-0313-00/01 Three Port Peripheral 
Interface (4110 Series Option 10) 
Service Manual 070-3815-00 
4110 Series Disk Options Service 
Manual 070-3812-00 
4110B Series Option 45 Mass Storage 
Interface Service Manual 070-481 1-00 
119-1644-00 10M Byte Hard Disk Drive 
Service Manual 
(for M4115B Option 46 or 47) 070-4731-00 
4115B Display Module Adjustment 
Graticule Instructions 062-7233-00 
Test Graticule Calibration Fixture 067-1142-00 
Extender Board Calibration Fixture 067-1005-00 
Flexible Extender Board Calibration 
Fixture 067-1163-00 
HRC Logic Extender Board Calibration 
Fixture 067-1173-00 
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4115B/M4115B terminal 
accessories H-1 
compatible products 1-6 
display module 2-24 
features 1-2 
general description 1-2 
options 1-5 
related manuals 1-1 
4953/4954 emulation 6-70 


accessories, terminal H-1 
Additive color mode 6-20 
active tablet area 6-70 
ADE 6-7 
alphanumeric keys 2-11 
alternate color index 6-24 
ANSI mode 6-21 
ANSI mode errors A-29 
arm for Block mode 6-14 
array parameter type 6-7 
ASCII code charts 
standard D-1 
with character parameters D-2 to D-6 
for optional keyboards E-2 to E-7 
ASCII decimal equivalent (see ADE) 
ASCII keys 2-11 
aspect ratio 2-21, 2-22 
attaching the graphics tablet 3-26 
autoconvergence 1-2, 2-8 
Automatic Request To Send (Half Duplex mode) 6-34 
Autorepeat feature 2-10 


Back Space key 2-13 

baud rate 5-2 

BAUDRATE 5-2, 6-11 
BCONTINUECHARS 5-5, 6-12 
BENDCHARS 5-5, 6-12 
BHEADERS 5-5, 6-13 

bias, how to restore 3-29 
BLENGTH 5-5, 6-13 
BLINELENGTH 5-5, 6-14 
block data packing 5-6, 6-16 
block header sequence 5-5, 6-13 
block length 5-5, 6-13 
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block line length 5-5, 6-14 

block master characters 5-6, 6-15 
Block mode 5-5, 6-14 

Block mode non-transmittable characters 6-15 
block timeout 5-6, 6-17 
block-continue characters 5-5, 6-12 
block-end characters 5-5, 6-12 
BLOCKMODE 5-5, 6-14 

blocks (data transmission) 5-5 
blocks (disk) 3-9 
BMASTERCHARS 5-6, 6-15 
BNONXMTCHARS 5-6, 6-15 
BORDER key 2-23 

BPACKING 5-6, 6-16 

Break key 2-13 

break time 2-14, 5-3, 6-16 
BREAKTIME 2-14, 5-3, 6-16 
BTIMEOUT 5-6, 6-17 

buttons (see controls) 

bypass cancel character 5-4, 6-17 
Bypass mode 6-17 
BYPASSCANCEL 5-4, 6-17 

byte macros 6-31 


CANCEL key 2-18 
Caps Lock key 2-15 
Carriage return 2-13 
implies line feed 6-23 
char parameters D-2 
character colors in dialog area 6-26 
character delete character 6-9, 6-35 
character parameter type (in setup commands) 6-7 
CLEAR key 2-18 
CMAP 6-18 
CMODE 6-19 
CMY color system 6-18 
CODE 6-21 
color copier 
multiplexed 3-24, 6-48 
spooling to 3-24 
use of 3-22 
color copy commands 3-22 
color modes 6-20 
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color index 6-18 
assignment to plotter pen 6-58 
default color assignments 6-19 
definition of 6-18 
for dialog area 6-24, 6-26, 6-28 
for graphics surfaces 6-18 
how to blink 6-18 
color purity, problems with 2-8 
color-overlay-mode parameter 6-20 
color-specifying-mode parameter 6-20 
color-to-gray-level transform 6-20 
command files 6-49 
command keys 2-14 
command line, maximum length of 6-8 
command summaries 
3PPI (peripheral ports) 3-17 
color copy 3-22 
disk drive 3-9 
escape sequence C-3 to C7 
file transfer 3-3 
host communications 5-1 
setup 6-3 
tablet setup 3-26 
command terminator 6-8 
command word 6-7 
abbreviations of 6-7 
communications (host) overview 5-1 
standard features 5-2 
connectors 
display unit 2-24 
electronics module 2-26, 2-27 
KEYBOARD 2-6 
pedestal 2-25, 2-27 
control characters 2-12 
in Snoopy mode 6-64 
control keys 2-12 
controls 
display 2-8 
electronics module 2-1 to 2-7 
pedestal 2-1 to 2-7 


CONVERGE button (DEGAUSS/CONVERGE) 2-8 | 


coordinate space 1-2, 2-21 

COPY 6-21 

copying a file 
host-to-plotter copy 3-20 
to a printer 3-21 
to/from a disk 3-12 
to/from a host 3-13, 6-23 
vs spooling 3-14 

CRLF 6-23 

crosshair cursor 4-2 

Ctrl key 2-12 
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cursor 
crosshair 4-2 
four-button 4-4 
GIN 4-2 
one-button 4-3 
segments used as 4-2 
stylus 3-28, 4-3 


DA2INDEX 6-24 
DABUFFER 6-24 
DACHARS 6-25 
DAENABLE 6-25 
DAINDEX 6-26 
DALINES 6-26 
DAMODE 6-27 
DAPOSITION 6-27 
DASURFACE 6-28 
data bits 6-54 data resolution 
for hard copies (see HCDATARES) 
internal 1-2, 2-21 
DAVIS 6-29 
defaults 
factory 2-5,6-3 
power-up 2-5 
reset to factory 2-5, B-5, F-2 
DEFINE 6-30, F-10 
DEGAUSS/CONVERGE button 2-8 
DELETE 3-12, 6-32 
deleting a file 3-12 
delimiters, string 6-8 
destination devices 3-2, 6-8 
device driver 3-14, 6-51 
device names 3-2, 6-8 
devices 
default 6-8 © 
destination 3-2, 6-8 
naming conventions 3-2, 6-8 
source 3-2, 6-8 | 
dialog area 2-16 to 2-17, 6-24 to 6-29, F-6 to F-9 
color map for (see DASURFACE) | 
enable/disable 6-25 
how to modify F-6 
visibility control 1-2, 1-4, 6-29 
width in characters (see DACHARS) 
writing mode 6-27 | 
dialog buffer 2-17, 6-24 
DIALOG key 2-16 
DIRECTORY 3-11, 6-32 
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directory 
entries on a disk 3-11 
examples of 3-11, 6-33 
how to generate 3-11, 6-32 
of a disk 3-11 
of a file 3-11 
to a disk file 3-11 
to a plotter 3-19 
to a printer 3-21 
disk drive 
basic description 3-5 
command summary 3-9 
indicator 2-7 
disks, flexible 
backing up 3-7 
changing 3-10 
inserting and removing 3-6 
formatting 3-9 
handling and safety 3-6 
life expectancy 3-6 
write-protecting 3-7 
disks, hard 3-7 
disks, information on format 3-9 
blocks 3-9 
directory entries 3-9 
sectors 3-9 
tracks 3-9 
disks, rigid 3-7 
DISMOUNT 3-10, 6-34 
display module 1-2, 2-8, 2-24 
documentation, list of 1-1 
DUPLEX 6-34 
duplex modes 5-6, 6-34 


ECHO 6-35 
EDITCHARS 6-35, F-6 
electronics module 2-26, 2-27 
end-of-file string 3-2, 5-3, 6-36 
end-of-line string 5-3, 6-37 
with directory to plotter 3-19 
with printer 3-21 
end-of-message characters 5-4, 6-37 
in GIN reports 6-62 
EOFSTRING 5-3, 6-36 
EOLSTRING 5-3, 6-37 
EOMCHARS 5-4, 6-37 
error codes A-1 to A-30 
ANSI A-29 
TEK A-6 
ERRORLEVEL 6-38 
error queue 6-38 
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errors 
3PPI hardware errors A-4 
ANSI A-29 
disk hardware errors A-3 
disk system context A-4 
DMA transfer A-5 
during power-up sequence B-1 
fatal B-2 
hardware errors A-3 
in Setup commmands 6-9 
reporting of 1-5, B-1 
severity levels A-1 
TEK A-6 
Esc key 2-13 
escape sequence commands 6-2, C-1 
in Local mode C-2 
in Setup mode C-1 
summary of C-3 
expand a macro 6-30 
extension, file 3-2, 6-9 
external clocking (see BAUDRATE) 


factory defaults 2-5, 6-3 
reset to B-5, F-2 

fatal errors B-2 

features of terminal 1-2 

file 3-2 

file devices 3-3, 6-8 

file extensions 3-2, 6-9 

file header 3-2 

file names 3-2, 6-9 

file transfers 3-2 
command summary 3-3 

filtering, graphics input 6-69 

FIXUP 6-38 

FLAGGING 5-2, 6-39 
purpose of 5-2, 6-39 

flexible disks (see disks, flexible) 

FORMAT 3-9, 6-39 

formatting a disk 3-9 
examples of 3-10 

four-button cursor 4-4 

framing box 2-21, F-13, F-14 

framing mode 2-21 

full duplex mode 5-6, 6-34 

function keys 2-19 
identifiers for DEFINE commands 6-30 


GAMODE 6-40 
GIN devices 4-1 
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GIN mode 4-1 
examples of use F-22 
how to disable 6-41 
how to enable 6-42 
overview 4-1 
using a plotter 4-4 
using a tablet 4-3 
GINAREA 6-40 
GINCURSOR 6-41 
GINDISABLE 6-41 
GINENABLE 6-42 
GINGRIDDING 6-42 
GININKING 6-43 
GINPICKAPERTURE 6-43 
GINRUBBERBAND 6-44 
GINSTARTPOINT 6-44 
GINWINDOW 6-45 
graphics area 1-3 
graphics area writing mode 6-40 
graphics input 
cursor 6-41 
examples of F-22 
Graphics Input mode (see GIN mode) 
graphics segment 1-3 
graphics surface 1-3, 6-18 
graphics tablet 
active writing area 4-3, 6-70 
attaching the tablet 3-26 
cleaning the tablet 3-28 
command summary 3-26 
cursors 4-3 
restoring the bias 3-29 
setup commands for the tablet 3-26 
use in GIN mode 4-3 
gray level 6-18 
mapping from colors to gray scale 6-18 
gray mode, how to specify 6-20 
gridding (in GIN mode) 4-2, 6-42 


half duplex mode(s) 5-6, 6-34 

half duplex with Supervisor mode 5-6, 6-34 

HARD COPY key 2-18, 3-22, 3-24 

hard copy image orientation 6-47 

hard copy interface 3-22, 6-46 

hard copy 
background parameter (see COPY) 
color 3-22 
how to make 3-22, 3-24, 6-22, 6-45 
monochrome copies 3-24 
monochrome copies via color interface 3-22 
reverse video 3-24, 6-22 
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hard copy unit (monochrome) 1-6, 3-24 
HCCOPIES 3-20, 6-45 
HCDATARES 3-20, 6-46 
HCINTERFACE 3-20, 6-46 
HCORIENT 3-20, 6-47 
HCRESERVE 6-48 
header characters (for tablet) 6-69 
HLS color system 6-18 
host communications 
command summary 5-1 
overview 5-1 
host-to-plotter copy 3-20 


IGNOREDEL 6-49 

indicator lights, keyboard 2-9 

initializing the terminal F-2 

inking 4-1, 6-43, F-22 

input queue 5-3, 6-60 

int parameters D-3 

int-report parameters D-4 

integer parameter type 6-7 

INTENSITY control 2-8 

interrupting host with Break key 2-13, 5-3 


key execute delimiter 6-30, 6-49 
key specifiers 6-7 
for DEFINE 6-30 
keyboard 2-9 
optional keyboards E-1 to E-6 
KEYBOARD connector 2-27, 2-28 
KEYEXCHAR 6-49 
keywords 6-8 
KYBD LOCK indicator light 2-9, 2-10 


LFCR 6-50 
line continue characters (Block mode) 5-5, 6-12 
line delete character 6-9, 6-35 | 
Line Feed key 2-12 
line feed implies carriage return 6-50 
literal character 6-7, 6-35 
examples of use 6-31, F-10 
LOAD 3-14, 6-50 
with disk files 3-14 
local echo 6-35 
local graphics, examples of F-11 
LOCAL key 2-18 
Local mode 2-18 
local programmability 3-10, 6-39, 6-51 
locate function 4-1 
locked keyboard 2-10, 6-51 
LOCKKEYBOARD 6-51 
LPOS 6-51 
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machine RGB color system 6-18 
macro 2-19, 6-30 
macro-identifier 6-30 
manual overview 1-1 
Mass Storage Interface 3-7 
master characters (block mode) 5-6, 6-15 
MASTER RESET button 2-5, B-2, B-3 
maximum line length 
for commands 6-8 
in Block mode 6-14 
“Memory” notation 6-10 
multiplexer, color copier 3-24, 6-48 


NEXT VIEW key 2-22 

non-transmittable characters (Block mode) 5-6, 6-15 
NORMAL key 2-22 

3Normal (Half Duplex) mode 6-34 


one-button cursor 4-3 
Opaque color mode 6-20 
op-code 6-2, C-1 
option list for terminal 1-5 
Overstrike mode 

in dialog area 6-27 

in graphics area 6-40 
OVERVIEW key 2-22 


packing values (Block mode) 5-6, 6-16 
page full condition 2-8, 6-52 
PAGE FULL indicator light 2-10 
Page key 2-14 
PAGEFULL 6-52 
PAN key 2-21 
parameter types 
in Setup commands 6-7 
parameters (for escape sequences) 
char D-2 
int D-3 
int-report D-4 
xy D-5 
xy-report D-6 
parameters (for Setup commands) 
defaults if omitted (see command descriptions) 
factory defaults 6-3 
how to specify omitted parameiers 6-10 
types of 6-7 
PARITY 5-2, 6-52 
parity 5-2, 6-52 
parity checking 6-52 
PASSIGN 3-15, 3-17, 6-53 
PBAUD 3-17, 6-54 
PBITS 3-17, 6-54 
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PCOPY 3-17, 6-55 
pedestal 2-25, 2-27 
PEOF 3-17, 6-56 
PEOL 3-17, 6-56 
peripheral port (See port) 
PFLAG 3-17, 6-57 
pick function 4-1 
PLOT 3-17, 3-19, 6-57 
plotter 
4662 settings 3-17, 3-18 
4663 settings 3-18 
device driver settings (see PASSIGN) 
directory to 3-19 
host-to-plotter copy 3-20 
port settings 3-18, 3-20 
set-up information 3-18 
use in GIN mode 4-4 
use of PLOT command 3-19 
use of SPOOL command 3-19 
plotter pen color assignments 6-58 
PMAP 6-58 
port commands, summary of 3-17 
port flagging 6-57 
port-end-of-file string 6-56 
port-end-of-line string 6-56 
port-to-port copy 6-55 
POWER switch 2-1, F-2 
power-up defaults 2-5 
power-up sequence 2-4, B-1 
errors during B-1 
PPARITY 3-17, 6-58 
PPORT device driver 3-15 
precision grid 3-28 
printer 
4641 settings 3-21 
4643 settings 3-20 
directory to 3-21 
end-of-line string 3-21 
port settings 3-20 
set-up information 3-20 
spooling to 3-21 
printing characters 2-11 
programming a key, examples of F-10 
Prompt mode 5-4, 6-59 
prompt string 5-4, 6-59 
PROMPTMODE 5-4, 6-59 
PROMPTSTRING 5-4, 6-59 
PROTECT 3-11, 6-60 
protecting a file 3-12, 6-60 


QUEUESIZE 5-3, 6-60 
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RCV indicator light 2-10 
real parameter type 6-7 
Replace mode 
in dialog area 6-27 
in graphics area 6-40 
related documentation 1-1 
remote echo 6-35 
REMOTE ON connector 3-7, 3-8 
RENAME 3-12, 6-61 
renaming a file 3-12 
RENEW 6-61 
REOM 6-62 
reports 
end-of-message indicator 6-62 
line length in 6-62 
signature characters 6-63 
reversing a multiplexed color copier 3-24, 6-48 
RESET button 2-5, B-3 
RESTORE key 2-22 
reverse video hard copy 3-24, 6-22 
RGB color system 6-18 
RGB, machine 6-18 
RLINELENGTH 6-62 
Rtn key 2-13 
RSIGCHARS 6-63 
Rub Out key 2-12 
rubberbanding 4-1, 6-44, F-23 


SAVE 3-14, 6-63 
examples of F-20, F-21 
to a plotter 3-19 
with disk files 3-14 
sectors, disk 3-9 
segment 1-3 
used as GIN cursor 4-2 
examples of manipulations F-13 
Self Test 2-5, B-2 
SELF TEST button 2-5, 2-6, B-3 
SET UP key 2-16, 6-1 
Setup mode 2-16, 6-1 
interactions with other modes & settings 6-2 
setup commands 6-1 
correcting errors in 6-9 
factory defaults (in Table 6-1).6-3 
parameter types 6-7 
summary of 6-3 to 6-6 
syntax conventions 6-10 
setup memory 2-5, 6-2 
reset to defaults B-5, F-2 
saved parameters 6-3 


severity levels, error 6-38, A-1 
Shift key 2-13 
signature characters 6-63 
single character parameter type 6-7 
SNOOPY 6-64 
software support 1-5 
source devices 6-8 
Space 
in Overstrike mode 6-27, 6-40 
in Replace mode 6-27, 6-40 
SPOOL 3-13, 6-65 
to acolor copier 3-21 
to a plotter 3-17 
to a printer 3-19 
STATUS 6-66, F-5 
STATUS COMMUNICATIONS F-6 
STATUS EDITCHARS F-5 
STOP 6-68 
stop bits 5-4, 6-68 
for peripheral ports 6-54 
STOPBITS 5-4, 6-68 
string delimiters 6-8 
string parameter type 
delimited 6-8 
undelimited 6-8 
stroke function 4-1, 4-2 
stylus 3-28, 4-3 
submessages in self test B-4 
substitute character 5-6 
Subtractive color mode 6-20 
supersurface 6-18 
Supervisor (Half Duplex) mode 5-6, 6-34 
syntax of escape sequence commands 
in Local mode C-2 
in Setup mode C-1 
syntax of Setup commands 6-10 


Tab key 2-13 

tablet, graphics (see graphics tablet) 

tape drive, use of 3-22 

TBFILTER 3-26, 6-69 

TBHEADERCHARS 8-26, 6-69 

TBSIZE 3-26, 6-70 

TBSTATUS 3-26, 6-70 

TEK mode 6-21 

TEK mode errors A-6 

Three-Port Peripheral Interface 
command summary 3-17 
description 3-15 
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thumbwheels 1-4, 2-10 
use in Framing mode 2-21, F-13 
use in GIN mode 4-2 
use in scrolling text 2-17, F-8 
time out (Block mode) 5-6, 6-17 
tracks, disk 3-9 
transmit delay 5-3, 6-71 
transmit limit 5-3, 6-72 
turnaround time 5-3 


Underscore with DAMODE 6-27 
user number 3-10, 6-71 
USERNUMBER 3-10, 6-71 


vernier action 2-22 

view 1-3, 2-20 to 2-22 

VIEW Key 2-21 

viewing keys 1-3, 2-20 to 2-23 
examples of use F-13 to F-19 

viewport 1-3, 2-21 

viewport update 6-61 


WRITE PROTECT switches 2-7, 3-7 
WRITE PROTECT indicators 2-7, 3-7 
write-protecting a disk 3-7 
write-protecting a file 3-12, 6-60 


XMT indicator light 2-10 
XMTDELAY 5-3, 6-71 
XMTLIMIT 5-3, 6-72 

xy parameters D-5 
xy-report parameters D-6 


ZOOM key 2-21 
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